连接管理
目录
- 概述
- 页面构成 — 3个子菜单
- 协议页面 (
/connect/index) - 状态页面 (
/connect/status) - 数据源详情页面 (
/connect/view) - Edge 页面 (
/edge/index) - Edge 详情页面 (
/edge/view) - 使用场景
- 常见问题
- 相关页面
概述
连接管理（Connectivity）组用于注册和巡检从外部系统(现场 PLC·OPC 服务器·文件·外部 DB·MQTT/Kafka 主题等)采集数据的连接。菜单由以下 3 个子页面组成：
| 子菜单 | 内部 URL | 用途 |
|---|---|---|
| 协议 | /connect/index | 新建连接注册 — 按数据源类型的添加入口 |
| 连接状态 | /connect/status | 运营中连接的通信状态·延迟·验证失败监控 |
| Edge | /edge/index | 现场 Edge 设备的系统状态和 PLC 采集统计 |
页面构成 — 3个子菜单
| 页面 | 主要用户 | 一句总结 |
|---|---|---|
| 协议 | 系统管理员 | 新增数据源(Edge/OPC/PLC/Modbus/外部 DB/文件·API) |
| 连接状态 | 操作员 | 连接正常/延迟/异常趋势和 24 小时断连·延迟·验证失败历史 |
| Edge | 操作员 | Edge 的 OS 状态(CPU/内存/磁盘/网络) + PLC 采集统计 |
本文档和页面中使用的连接状态名称为连接正常 · 连接延迟 · 连接异常 · 连接断开 · 未观测
五种。代码值依次为 OK · WARN · ERROR · DISCONNECTED · UNKNOWN，
定义见 状态代码定义。
部分旧版页面(如资产树图例)将 OK 记为"正常连接" — 指的是同一状态。
协议页面 (/connect/index)
页面顶部显示指导框。
🌐 工业协议及其他数据源的连接 [推荐] 与 PlantPulse Edge 网关无缝集成，无需配置。 支持工业中广泛使用的 OPC 和 PLC、Modbus 协议及数据库的连接和数据采集。此外，通过提供的客户端 API，还支持从 MQTT、STOMP、KAFKA、HTTP 采集。(OPC 自动连接，其余需使用相应的 Edge 网关或采集器)
数据源分类
页面按分类划分为多个大节，每个节内以数据源类型的图标卡片(含连接链接)网格显示。
| 节 | 显示卡片 | 额外链接 |
|---|---|---|
Edge 网关 / 文件 / API [N] | Edge 网关·MQTT·REST API·Excel·CSV (5种) | /connect/file/add |
OPC [N] | OPC 标准数据源 (自动连接) | /connect/opc/index 列表 |
PLC [N] | PLC 通信 (制造商协议) | /connect/plc/index 列表 |
Modbus [N] | Modbus TCP/RTU | /connect/modbus/index 列表 |
数据库 [N] | 外部 DB 轮询 | /connect/database/index 列表 |
每个节的标签旁 [N] 为当前注册的连接数。右侧"查看列表"链接跳转到分类列表页面。
OPC 列表页面 (/connect/opc/index)
通过数据源分类中的 OPC 行"查看列表"或侧边菜单进入。在 12 列表格中一览所有已注册 OPC 服务器连接的运营状态。
| 列 | 宽度 | 显示 |
|---|---|---|
| No. | 60px | 行号 |
| 连接 ID | 100px | OPC 域徽章 |
| OPC 名 | 250px | 显示名 |
| 状态 | 70px | 全彩渐变状态圆点 (正常/延迟/异常/断开/未知) |
| 协议类型 | 60px | 深色徽章 — protocol-badge-opc-ua (深蓝) / protocol-badge-opc-da (紫色)。黑色背景 + 白色文字，与其他列徽章区分 |
| 程序 ID | IP | 自动 | OPC 服务器的 ProgID 或 IP 地址 |
| 启动 | 60px | ▶ 采集启动 / ◼ 停止 (按当前状态显示) |
| 采集启动时间 | 120px | 采集开始的时刻 (scan_start_time) |
| 连接的标签数 | 70px | 映射到该 OPC 的标签数 |
| 全部 / 今日接收数据点 | 80px | 累计 / 今日接收数据点数 |
| 错误 | 60px | 累计错误数 (红色突出) |
| 操作 | 80px | 🔧 编辑 / 🗑 删除 (仅有变更权限的角色可操作) |
表头右侧的 ↻ 图标按钮刷新。帮助框在页面下方显示，提供 OPC 连接建议(每个连接 1,000 个标签以内等)。
添加新连接
单击各卡片的连接链接，打开相应数据源类型的注册表单。表单根据数据源类型的不同包含不同的输入项，通常共同输入以下内容：
| 通用输入 | 说明 |
|---|---|
| 站点 | 选择要注册连接的站点 |
| OPC ID 或名称 | 域标识符 (建议仅使用英文/数字/_) |
| 连接信息 | 主机/端口、认证、主题、文件路径等 (因数据源而异) |
| 采集周期·选项 | 轮询周期、启动/结束时间等 |
| 说明 | 备注 |
注册后，在 连接状态 页面确认实际数据导入之前，仅是简单的元数据注册状态。采集启动时，连接状态 的卡片上会显示"连接正常"徽章。
状态页面 (/connect/status)
在一个页面中监控所有运营中数据源连接的状态。
顶部工具
📡 연결 상태 [총 N 개의 데이터소스 연결] [사이트 ▼] [검색] [↻]
| 控制 | 宽度 | 说明 |
|---|---|---|
站点选择器 (site_id) | 200px | 全部站点 + 已注册站点列表 (사이트명 [설명]) |
| 搜索 | 红色 + 🔍 | 应用站点过滤并刷新卡片 |
| 刷新 | 红色 + ↻ | 页面刷新 |
左侧 — 统计图表和历史
左侧 col-lg-2 区域纵向排列 5 个图表和 3 个历史面板。
1) 连接状态分布 (connection_stat_chart, 200px)
所有已注册连接的 5 阶段状态(连接正常·连接延迟·连接异常·连接断开·未观测)分布，用圆环图表示。
2) 通信连接状态趋势 [今日] (connection_trend_chart, 150px)
按时段按状态统计连接数的变化趋势 (近 24 小时)。
| 颜色 | 含义 | 阈值 |
|---|---|---|
| 🟢 绿色 | 连接正常 | 10 分钟内收到数据 |
| 🟠 橙色 | 连接延迟 | 10 分钟以上未收 |
| 🔴 红色 | 连接异常 | 1 小时以上未收 |
| 🟥 深红 | 连接断开 | 24 小时以上未收 |
| ⬜ 灰色 | 未观测 | 无数据接收历史 |
ℹ️ 标题的信息图标上悬停可显示上述 5 阶段标准提示。
3) 通信延迟状态趋势 [今日] (latency_trend_chart, 150px)
| 颜色 | 含义 | 阈值 (区间最大延迟) |
|---|---|---|
| 🟢 绿色 | 正常 | 10 秒以内 |
| 🟠 橙色 | 延迟 | 10 秒 ~ 60 秒 |
| 🔴 红色 | 严重延迟 | 60 秒以上 |
提示显示"平均延迟 1 秒以内 / 1~10 秒 / 10 秒以上"，但柱状图的计算基于
该时间段的最大延迟(max_latency) 10 秒·60 秒阈值。读图时请参照上表。
平均延迟 3 秒的连接在此图表中显示为绿色正是因为这样。平均延迟 1 秒/10 秒是资产 健康状态判定中使用的独立标准 — 状态代码定义 中并列说明了两种标准。
4) 数据点验证失败趋势 [今日] (point_fail_trend_chart, 150px)
接收到的数据点在类型·范围·有效性验证中失败的数量，按小时汇总。
5) 最近连接断开 [近 24 小时] (connection_status_history, 200px 可滚动)
24 小时内连接断开的数据源历史。按时间逆序列表 — 数据源 ID、断开时刻、最后正常时刻。
6) 最近接收延迟 [近 24 小时] (connection_latency_history, 200px 可滚动)
24 小时内发生响应延迟的数据源历史。
7) 最近数据点验证失败 [近 24 小时] (point_validation_status_history, 400px 可滚动)
24 小时内发生验证失败的数据点历史。
右侧 — 数据源卡片网格
右侧 col-lg-10 区域按分类显示数据源卡片网格。
卡片分类 (从上到下)
| 节标题 | 显示 |
|---|---|
Edge 网关 / 文件 / API [N] | FILE 类型数据源 (Edge GW·文件·API 等) |
PLC [N] | PLC 数据源 |
| (之后是 OPC·Modbus·外部 DB 等) | 已注册数据源类型 |
卡片组成 (opc_obj)
┌─────────────────────┐
│ [SUB_TYPE] │ ← 작은 글씨
│ OPC_ID │ ← ID
│ ──────────────── │
│ 현재 상태값(_mm) │ ← 매분 갱신 상태 표시
└─────────────────────┘
| 区域 | 显示 |
|---|---|
| 顶部 | 数据源子类型 (例: FILE, MQTT, REST_API) |
| 中间 | 数据源 ID — 溢出时省略(...) |
| 底部 | 每分钟状态显示 (${opc_id}_mm) — 颜色映射到 5 阶段状态 |
单击卡片进入该数据源的详情页面(
/connect/view?opc_id=...)，可查看采集历史·标签列表·日志。悬停时卡片说明显示为提示。
空状态提示
若该分类未注册数据源：
无连接的代理
数据源详情页面 (/connect/view)
单击 状态页面 的数据源卡片进入。汇总了一个 OPC/PLC/DB 连接所有运营信息的页面。
页面标题
📶 프로토콜 연결 보기 [📅 날짜 선택 ▼] [날짜 이동 →] [← 목록] [↻]
{site_name} / {opc_name}
| 控制 | 动作 |
|---|---|
| 日期选择 | 日历 — 查询其他日期的连接状态 |
| 日期跳转 → | 用选定日期重新加载 |
| ← 列表 | 返回状态页面 |
| ↻ | 刷新页面 |
左侧 ① 连接基本信息 + 展开
面板标题右侧两个按钮：
| 按钮 | 动作 |
|---|---|
⌄ 展开 (viewOPCDetail()) | 切换站点信息节的显示 |
| ⚙ 连接设置 | 前往该数据源的编辑表单 (需要变更权限) |
基本信息 (ds-dl)
| 项目 | 显示 |
|---|---|
| 连接 ID | OPC 域徽章 |
| 连接名 | 数据源显示名 |
| 说明 | 备注 |
| 注册日 | 注册时刻 (等宽) |
协议连接信息 (ds-dl)
| 项目 | 显示 |
|---|---|
| 连接类型 | OPC_UA / OPC_DA / PLC / MODBUS / DB / FILE 等 |
| 子类型 | 制造商·具体协议 (例: SIEMENS_S7, MITSUBISHI_MC) |
| 代理 IP / 端口 | 代理(Edge)的 IP·端口 (等宽) |
站点信息 (仅展开时)
| 项目 | 显示 |
|---|---|
| 站点 ID | 站点域徽章 |
| 站点名 | 站点显示名 |
左侧 ② 连接统计 (延迟·状态 5种)
今日最高延迟趋势 (3 格)
| 格 | 显示 |
|---|---|
| 最低 | 最快响应延迟 (ms, 逗号分隔) |
| 平均 | 平均响应延迟 |
| 最高 | 最慢响应延迟 |
下方显示 24 小时延迟趋势线图 (latency_24hh) — 如有异常尖峰，可在 状态 页面进一步确认。
连接异常数
只读输入框显示今日累计"连接异常"计数。
状态统计 5 格网格
┌─🟢 연결─┐ ┌─🟠 지연─┐ ┌─🔴 이상─┐ ┌─⬛ 끊김─┐ ┌─⚪ 미관측┐
│ 12,453│ │ 23 │ │ 5 │ │ 1 │ │ 0 │
└────────┘ └────────┘ └────────┘ └────────┘ └────────┘
五种颜色的格子中分别以大数字显示累计计数，下方配合小圆环图表 (connection_priority_count_chart)。
右侧 ① 连接状态时间线 + LIVE 圆点
面板标题辅助文本："今日连接/断开时间线 [{status_txt}]"。标题右侧 ⓘ 信息图标 — 悬停时显示指导提示。
左侧 — 当前状态卡片 (live)
大图标 + 标签形式的状态卡片 (last_connection_status)。
| 图标 + 标签 | 含义 | 圆点切换 |
|---|---|---|
❓ 未观测 (is-mute) | 无数据接收历史 | ⚪ 灰色 |
🟢 连接正常 (is-ok) | 10 分钟内收到数据 | 🟢 LIVE 圆点 (脉冲) |
🟠 连接延迟 (is-warn) | 10 分钟~1 小时未收 | 🟠 |
🔴 连接异常 (is-err) | 1~24 小时未收 | 🔴 |
⬛ 连接断开 (is-disc) | 24 小时以上未收 | ⬛ |
🟢 LIVE 圆点脉冲闪烁表示数据实时进入。悬停时显示最后接收时刻的提示。
右侧 — 24 小时时间线条 (opc_connection_timeline)
24 小时横向条形表示，各时段的连接状态用 5 种颜色填充。鼠标悬停条形上时，提示显示该时刻的状态。
右侧 ② 数据点接收 24 小时图表
面板标题辅助："今日 24 小时每分钟接收数"。
每分钟接收数据点数的折线图 (opc_point_trend_24h)。如果与平时营业时间相比急剧下降，则说明该时段数据导入中断。加载中时中央显示"加载中..."提示。
右侧 ③ 连接的标签列表
该数据源映射的标签实时值列表 (7 列)。
| 列 | 宽度 | 显示 |
|---|---|---|
| 标签 ID | 80px | 域徽章 |
| 标签名 | 350px | 标签显示名 |
| 数据类型 | 100px | INT/FLOAT/STRING/BOOL 等 |
| 当前值 | 自动 | 最后接收值 (品质颜色徽章) |
| 最后更新时间 | 自动 | 接收时刻 |
| 延迟 [MS] | 自动 | 平均响应延迟 |
| 操作 | 50px | 🔍 → 跳转到该 标签详情 |
表通过 WebSocket 实时更新。值不闪烁表示该标签的接收已中断。
Edge 页面 (/edge/index)
在一个页面中实时监控现场 Edge 设备的系统状态和 PLC 采集统计。 页面副标题为"实时监控 Edge 的连接状态和 PLC 数据采集现况"。
顶部工具
📡 엣지 [사이트 ▼] [검색] [↻]
| 控制 | 宽度 | 说明 |
|---|---|---|
站点选择器 (site_id) | 200px | 全部站点 + 已注册站点 |
| 搜索 | 🔍 | 应用站点过滤 |
| 刷新 | ↻ | 列表即时重新查询 |
列表每 60 秒自动重新查询。帮助框中的"每 10 秒"不是屏幕刷新周期，而是 Edge 向服务器上报自身状态的周期 — 两者容易混淆。 要立即查看刚改变的值，请按 ↻。
列表表格 (8列)
相关指标在一列中合并。与之前 CPU·内存·磁盘各占一列的方式不同。
┌────────────────────────── 목록 ──────────────────────────┐
│ 연결 │ EDGE_ID │ 엣지 │ 리소스 │ 네트워크 │ PLC │ 처리량 │ 액션 │
└──────────────────────────────────────────────────────────┘
| 列 | 宽度 | 显示 |
|---|---|---|
| 连接 | 60px | 连接状态图标徽章 (🔌 连接断开 / ⚠ 警告) |
| EDGE_ID | 130px | Edge 设备标识符 |
| Edge | 260px | Edge 名称 (+ O/S 主机名·版本) |
| 资源 | 150px | CPU · 内存 · 磁盘利用率在一格中 |
| 网络 | 110px | NET 1 / NET 2 / WiFi / VPN 状态在一格中 |
| PLC | 80px | PLC 连接正常 / 连接断开数 |
| 吞吐量 | 110px | 当前采集速度(mps) · Σ 累计接收数据点 + 近 24 小时按小时接收量迷你图 |
| 操作 | 110px | 详情查看等 |
吞吐量格中的迷你图中，空白段表示"0 条接收"而非"无观测"。 鼠标悬停格中时会用提示显示同样的说明。
Edge 帮助框
页面下方显示以下运营指南 (4 项)。
❓ Edge 帮助 在 Edge 菜单中，可以查看 Edge 的连接及 PLC 数据采集状态。
- 状态显示为连接断开 [🔌] 的 Edge，必须检查物理环境、网络及 Edge O/S。
- 状态显示为警告 [⚠] 的 Edge 表示采集时存在 S/W 错误，请登录 Edge 解决问题。
- CPU/内存/磁盘利用率 80% 以上时，请检查 Edge 并整理资源。
- Edge 的状态每 10 秒更新一次。
运营流程 (发现异常时)
- 连接为 🔌(连接断开)的 Edge → 现场巡检 (电源·网络·硬件)
- CPU/内存/磁盘 80% 以上 → 登录 Edge 整理不必要的进程/日志
- PLC 连接断开数不为 0 → 检查该 Edge 的 PLC 电缆·配置
Edge 详情页面 (/edge/view)
单击 Edge 列表的 EDGE_ID 或"操作"列进入单个 Edge 的详情页面。可在一个页面处理以下事项：
- 注册元数据 / 主机 / 网络 / 安全密钥确认
- CPU·内存·磁盘实时仪表
- PLC 采集统计 8 个指标
- 连接到 Edge 的 OPC 服务器列表和采集启动/停止
- Edge 上运行的 Docker 容器列表和启动·停止·重启·日志·删除
- 新容器远程部署
- Edge 应用重启及 Edge 主机 OS 重启
⚠️ 此页面的所有控制命令直接在现场 Edge 设备上执行。运行中的 Edge 在停止 OPC 采集·删除容器·系统重启时会中断采集数据。必须在维护时间段执行。
顶部页面标题和刷新
🛜 ${엣지명} [← 목록] [⚡ 실시간 새로고침] [↻ 새로고침]
사이트: ${site_id} · 엣지 ID: ${edge_id} · ${설명}
| 控制 | 动作 |
|---|---|
| ← 列表 | 返回 /edge/index |
| ⚡ 实时刷新 | 直接调用 Edge 设备，用最新值更新仪表·OPC 列表·Docker 列表 |
| ↻ 刷新 | 整页刷新 |
此页面中自动运行的只有两种：
| 对象 | 周期 | 来源 |
|---|---|---|
| 左侧信息面板·PLC 统计等保存值 | 30 秒 | 平台存储的 read-model (/edge/{id}/model) — Edge 约 60 秒心跳上报的值 |
| 升级可用性检查 | 5 分钟 | — |
系统资源仪表 · OPC 列表 · Docker 容器列表在进入屏幕时仅调用 Edge 一次。 之后仅在按下**⚡ 实时刷新**时重新读取。 这样设计是为了避免频繁访问设备。
因此长时间打开页面查看仪表，该值是进入页面时的值。 现场采取措施后要查看结果，必须按⚡。
连接 / 健康时间线标签
统计区域分为 2 个标签。
| 标签 | 内容 |
|---|---|
| 连接状态时间线 (默认选中) | 过去 24 小时的可达性 |
| 健康状态时间线 | 过去 24 小时的 PLC 连接 & 采集 |
健康时间线在标签被点击显示在屏幕时绘制。标签打开前为空是正常的。
左侧 — 基本信息·主机·网络·安全 4 面板
左侧 col-lg-3 区域纵向堆放 4 个面板。都是定义列表(标签 / 值)格式。
① 基本信息 — 含系统重启按钮
| 项目 | 含义 |
|---|---|
| Edge ID | 域 ID 徽章 (EDGE 域颜色) |
| 名称 | edge_name |
| 站点 | 站点 ID (域徽章) |
| 角色 | role (无则显示 -) |
| 状态 | 主表中的 status 值 |
| 说明 | 备注 |
| 注册日 | Edge 首次注册的日期时间 |
| 最后状态 | 最后接收到心跳的日期时间 |
面板标题右侧有🔴 红色 ⏻ 电源图标按钮 — 点击后 Edge 主机 OS 重启 (见下方 安全流程)。
② 主机
| 项目 | 含义 |
|---|---|
| 主机名 | 操作系统的 hostname |
| 版本 | Edge 软件编译版本 |
| 编译日 | 编译日期 |
| CPU 核心 | 核心数 |
| 线程 | 线程数 |
| 温度 | CPU 温度 (°C) — 无温度传感器显示 0 |
③ 网络
VPN / NET 1 / NET 2 / WiFi / 管理网 / GSM 6 个接口的 IP。未设置时显示 -。
| 项目 | 用途 |
|---|---|
| VPN IP | 总部 ↔ 现场 VPN 隧道的 Edge 端地址 |
| NET 1 | 主 LAN |
| NET 2 | 副 LAN |
| WiFi | 无线 |
| 管理网 | OOB 管理网络 |
| GSM | LTE/3G 备用线路 |
④ 安全
| 项目 | 显示 |
|---|---|
| API Key | Edge 向服务器认证时使用的密钥 — 前 4 字 + **** + 后 4 字掩码 |
与 Flow REST 节点的 X-API-Key 相同 — 仅在此页面以掩码形式确认，实际密钥值不显示。
右侧 ① 系统资源仪表 + 应用重启
面板标题带 ⓘ "CPU · 内存 · 磁盘利用率 (实时)"标签，右侧有应用重启按钮。
状态行 (state-row)
仪表上方显示一行状态消息。
| 显示 | 含义 |
|---|---|
🟢 엣지 LIVE — 정상 응답 중 | Edge 响应 ping |
🔴 엣지 OFFLINE | Edge 的 /api/v1/monitoring 为 ping=false |
🔴 엣지 UNREACHABLE | HTTP 请求本身失败 (网络断连) |
仪表 3 个 (各 140px 圆环)
| 仪表 | 单位 | 颜色阈值 |
|---|---|---|
| CPU 利用率 | % | < 80 绿色 · 80~89 橙色 · ≥ 90 红色 |
| 内存利用率 | % | 同上 |
| 磁盘利用率 | % | 同上 |
值显示至小数点后 1 位 (例: 73.4%)。
应用重启按钮
仅重启 Edge 应用(守护进程)。主机 OS 不受影响。
🔄 点击后确认对话框 → "重启" → 约 3 秒后 Edge 进程自体重启，约 10 秒后返回。期间仪表·统计临时显示
-。
右侧 ② PLC / 采集统计 (8格 stat-box)
8 个统计框网格排列。
| 框 | 单位 | 含义 | 强调 |
|---|---|---|---|
| 连接正常 | 个 | PLC 连接存活的个数 | 🟢 ok |
| 连接断开 | 个 | PLC 连接断开的个数 | 🔴 err |
| 读取成功 | 个 | PLC 轮询成功累计计数 | - |
| 读取失败 | 个 | PLC 轮询失败累计计数 | 🔴 err |
| 传输数据点 | 个 | 向服务器传输的累计数据点数 | - |
| MPS | 个/秒 | 消息处理速度 (每秒数据点) | - |
| 平均延迟 | MS | 最近窗口的平均响应延迟 | - |
| 最高延迟 | MS | 最近窗口的最大响应延迟 | - |
计数器(读取成功·失败·传输数据点)在 Edge 进程重启后从 0 重新开始。应按趋势而非绝对值理解。
右侧 ③ OPC 状态 + 5种概览芯片 + 采集启动/停止
面板标题为"连接到 Edge 的 OPC 服务器列表和采集状态"。
5种概览芯片 (opc-chip-v2)
每个芯片由图标 + 大数字 + 标签组成。
| 芯片 | 图标 | 含义 | 颜色 |
|---|---|---|---|
| 注册 | ☰ | 映射到此 Edge 的 OPC 服务器总个数 | 灰色 |
| 连接 | ✓ | connection_status = CONNECTED 个数 | 🟢 绿色 |
| 采集中 | ≋ | 连接正常 + scan_status = START | 🟢 绿色 |
| 停止 | ⏸ | scan_status = STOP 个数 | 灰色 |
| 断开 | 🔗∕ | connection_status ≠ CONNECTED 个数 | 🔴 红色 |
列表表格 (7列)
| 列 | 宽度 | 显示 |
|---|---|---|
| OPC ID | 160px | 🔌 + ID (点击进入 /connect/opc/edit/{id} 编辑页面) |
| 名称 | 自动 | opc_name |
| 类型 | 80px | OPC UA / OPC DA 徽章 |
| 代理 IP | 140px | OPC 代理 IP (等宽) |
| 连接 | 90px | 🟢 已连接 / 🔴 其他 — 圆点表示 |
| 采集 | 90px | 🟢 启动 / 🟡 其他 / ⚫ 停止 — 圆点 |
| 控制 | 160px | 操作按钮 (下方) |
控制按钮
| 状态条件 | 显示按钮 | 动作 |
|---|---|---|
scan_status ≠ START | 🟢 ▶ 采集启动 | 确认 → POST /edge/{edge_id}/opc/{opc_id}/start → 2 秒后刷新页面 |
scan_status = START | 🔴 ◼ 采集停止 | 确认 → POST /edge/{edge_id}/opc/{opc_id}/stop → 2 秒后刷新页面 |
| 始终显示 | ⚙ OPC 编辑 | 跳转到 /connect/opc/edit/{opc_id} 编辑页面 |
采集停止对话框以 ⚠️ 警告色 (橙色)显示 — 实际会中断数据。
右侧 ④ Docker 容器 (远程部署·启动·停止·日志·删除)
Edge 主机 Docker 中运行的容器列表每 5 秒更新。
面板标题
| 按钮 | 动作 |
|---|---|
| ↻ | 即时刷新 |
| ➕ 新建部署 | 容器部署对话框 (输入名称·镜像·端口·环境变量) |
列表表格 (6列)
| 列 | 宽度 | 显示 |
|---|---|---|
| 名称 | 160px | ▢ 立方体图标 + 容器名 (粗体) |
| 镜像 | 自动 | 镜像标签 (等宽，例: grafana/grafana:latest) |
| 状态 | 80px | 🟢 运行中 / 🔴 停止芯片 |
| 最近状态 | 200px | docker status 文本 (例: Up 3 hours) |
| 端口 | 200px | 호스트:컨테이너/프로토콜 逗号分隔 |
| 控制 | 240px | 5 种操作按钮 (下方) |
控制按钮 (所有行通用)
| 按钮 | 颜色 | 动作 |
|---|---|---|
| ▶ 启动 | 🟢 绿色 | POST /app/{name}/start |
| 🔄 重启 | 🟡 橙色 | POST /app/{name}/restart |
| ◼ 停止 | 🔴 红色 | POST /app/{name}/stop (警告对话框) |
| 📄 日志 | 灰色 | GET /app/{name}/logs → 宽对话框显示容器标准输出 |
| 🗑 删除 | 红色文本 | DELETE /app/{name} (危险对话框) — 即使运行中也会强制终止 |
新建部署对话框
| 输入 | 示例 |
|---|---|
| 容器名称 | grafana |
| 镜像 | grafana/grafana:latest |
| 端口 (host:container, 逗号分隔) | 3000:3000 |
| 环境变量 (KEY=VAL, 逗号分隔) | GF_SECURITY_ADMIN_PASSWORD=admin |
部署由 Edge 主机的 Docker 守护进程接收，执行镜像 pull + run。大镜像需要时间，刷新列表查看进度。
系统重启·应用重启 安全流程
🔄 应用重启 (仅 Edge 应用)
- 系统资源面板右上角点击应用重启
- 确认对话框 → "重启"
- 约 3 秒后进程自体重启
- 约 10 秒后返回 — 仪表·统计自动填充
影响：PLC/OPC 采集约 10~15 秒中断。CEP 报警评估在服务器端继续。累计计数从 0 重新开始。
⏻ 系统重启 (Edge 主机 OS)
左侧 ① 基本信息面板标题的 🔴 ⏻ 按钮。
- 确认对话框以**危险(红色)**显示
- 约 1 分钟无响应，OS 完全启动后才返回
- 启动中 PLC/OPC 全断 — 容器一起停止/重启
仅在以下情况使用：① 内存/磁盘到 100%，应用重启无法恢复。② 主板本身响应变慢。通常先尝试应用重启。
使用场景
| 场景 | 页面 | 流程 |
|---|---|---|
| 新生产线 OPC 注册 | 协议 → OPC 卡片 → 连接 | 输入站点·OPC ID·服务器地址 → 保存 |
| 运营中连接断开全面巡检 | 状态 | 左侧"最近连接断开"24 小时历史 → 右侧卡片的红色·深红色卡片识别 |
| 数据点验证失败原因分析 | 状态 | 左侧"验证失败趋势" + "最近验证失败" → 资产 ID + 时刻 → 趋势页面对比 |
| Edge 设备资源巡检 | Edge | CPU/内存/磁盘 80% 以上设备识别 → 现场整理 |
| PLC 断连站点识别 | Edge | "PLC 连接断开"列排序 → 非 0 值站点的 Edge 巡检 |
| 网络延迟分析 | Edge | "最高延迟 [MS]"排序 → 10 秒以上设备的网络巡检 |
| Edge 上 Grafana·集成容器重启 | Edge 详情 → Docker | 容器行的 🔄 重启 (不需整页刷新) |
| 现场 OPC 临时停止后巡检 | Edge 详情 → OPC | 相应 OPC 行的 ◼ 采集停止 → 巡检后 ▶ 采集启动 |
| Edge 响应缓慢恢复 | Edge 详情 → 系统资源 | 应用重启 (影响 10 秒)。无效则 ⏻ 系统重启 (影响 1 分钟) |
| 新监控工具远程部署 | Edge 详情 → Docker → ➕ 新建部署 | 输入镜像·端口·环境变量后部署 — 镜像 pull 自动 |
常见问题
Q. 注册了 OPC 数据源，但 [状态] 页面看不到卡片。 A. 注册直后应以"未观测"(灰色)状态显示卡片。看不到则确认在站点选择器中选择了注册该 OPC 的站点。
Q. [状态] 的趋势图表为空。 A. 该站点本身没有数据源，或今天完全无数据导入。数据源注册直后，等待首次导入。
Q. 图表上的信息图标 ℹ 提示被截断。 A. 鼠标悬停信息图标会显示 5 阶段状态标准表提示。屏幕宽度窄会被截断，请加宽屏幕或参考 状态代码定义 页面。
Q. Edge 状态不更新。 A. 周期分三层容易混淆：① Edge 向服务器上报状态的周期10 秒，② 列表页面从服务器重新查询的周期60 秒，③ 详情页面保存值的更新周期30 秒。所以列表中值最多晚显示 1 分钟是正常的。超过这么久不变则 Edge 无法发送响应(连接断开)。现场巡检或查看 诊断 中 EDGE 应用日志。
Q. 详情页面的 CPU 仪表始终显示相同值。 A. 仪表·OPC 列表·Docker 列表不自动更新 — 进入页面时仅调用 Edge 一次。按下**⚡ 实时刷新**。
Q. PLC 连接断开列增加到 1，怎样确认？ A. 该 Edge 的操作按钮进入详情页面可查看 PLC 单位状态。或在 状态 页面的 PLC 卡片网格中识别红色卡片。
Q. CPU/内存 100% 的 Edge。 A. 立即登录现场整理不必要进程，重复出现则考虑设备规格升级或调整采集周期。
Q. 点击卡片出现空白页面。
A. 跳转到数据源详情页面(/connect/view)，但无导入数据显示为空。仅有导入历史的数据源才显示丰富信息。
Q. 实时自动更新吗？
A. [状态] 页面的卡片每分钟显示(_mm)自动更新。左侧统计图表按一定周期更新，即时反映需按右上角 ↻ 刷新按钮。
Q. "接收数据点数"突然变成 0。 A. Edge 计数器重启会从 0 重新开始。判断真 0 还是计数器重置，参考 日常统计 页面的站点数据数。
Q. Edge 详情页面(/edge/view)中停止了 OPC 采集，过段时间又变成 START。
A. OPC 本身可能启用了自动重启选项，或来自工作流的自动启动命令。检查 OPC 编辑 页面的自动重启设置。永久停止则禁用 OPC 本身。
Q. Docker 容器面板为空。 A. ① Edge 可能非 Docker 使用模式 — 部分 Edge 采用 systemd 直接启动方式。② Edge OS 的 Docker 守护进程可能不响应 (此情况 ↻ 刷新仍为空)。现场巡检或考虑 ⏻ 系统重启。
Q. 容器 ▶ 启动·🔄 重启·◼ 停止按钮都显示。哪个有效？ A. 所有按钮始终可点击 — 无论 Docker 状态如何都发送命令。已运行中再按 ▶ 启动可能无错误或重启，**看状态芯片(🟢 运行中 / 🔴 停止)**再选择意图的命令。
Q. ⏻ 系统重启和 🔄 应用重启的区别？ A. ① 应用重启 (影响 10 秒) — 仅重启 Edge 守护进程，OPC/PLC 采集 10 秒中断。② 系统重启 (影响 1 分钟) — 整个 Edge 主机 OS 重启，Docker 容器一起重启。通常始终先尝试应用重启。
Q. API Key 显示掩码，怎样查看实际值？ A. 掩码是有意应用的 — 屏幕任何地方不显示明文密钥。与 Flow REST 节点 的 X-API-Key 相同，首次获得时妥善保管。丢失时向运营者申请重新发放。