连接管理
目录
- 概述
- 画面构成 — 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 [84] — 方括号数字为 当前注册的连接数 |
| ③ | 节右侧 | 查看列表 — 跳转至该类别的连接列表画面 |
| ④ | 卡片下方 | 连接 — 打开该类型的 注册表单 |
| ⑤ | OPC [37] — Platform 直接连接的唯一系列 | |
| ⑥ | PLC [135] — 各厂商协议 | |
| ⑦ | Modbus [6] | |
| ⑧ | 最后 | 数据库 [0] — 若无注册项则显示为 [0] |
数据源类别
页面按类别分为大节，每节以网格形式显示数据源种类的图标卡片（包含连接链接）。
| 节 | 显示卡片 | 添加链接 |
|---|---|---|
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 个标签以下等）。
添加新连接 (/connect/{opc,plc,modbus,messaging,database,api}/add)
点击各卡片的 连接 链接即可打开注册表单。
OPC · PLC · Modbus · 消息队列 · 数据库 · API 这六种注册表单的 输入项完全相同(共用产品的 _connection-form-body.jsp)。
仅标题·图标·保存地址以及可选择的协议列表（对应该源类型）有所不同。
各协议的详细设置 — 轮询周期, 认证, 主题, 文件路径, 寄存器地址 — 不在此表单中。 此处仅注册 «哪个设备在什么位置», 实际采集设置在负责该协议的 Edge 网关或采集器 端进行
(Platform 直接采集的协议为 API 和 POSTGRESQL)。
输入项 (通用)
| 输入 | 必填 | 规则 | 说明 |
|---|---|---|---|
| 站点名称 | ✅ | 从列表选择 | 该连接所属的站点 |
| 连接 ID | ✅ | 以 OPC_ 开头, 大写字母·数字·_ | 注册后 不可修改 (修改模式下为只读) |
| 源类型 | — | 只读 | 根据所选协议确定 (OPC / PLC / MODBUS / DATABASE / MESSAGING / API / SYSTEM) |
| 连接名称 | ✅ | 可读名称 | |
| 协议 | ✅ | 从列表选择 | 实际协议 — 详见下表 |
| Edge | — | 只读 | 采集此连接的 Edge。若为 Platform 直接采集协议，则显示「Platform 直接采集」 |
| 源 IP | — | 最多 255 字, IP 或主机名 | 实际源 (PLC·设备·OPC UA 服务器·DB·代理) 的地址 |
| 源端口 | — | 0 ~ 65535 | 实际源的端口 |
| 说明 | ✅ | 备注 |
OPC_ 开头校验式仅为 ^OPC_[A-Z0-9_]+$。PLC_001 · EDGE_00303 · DB_ERP 将不被保存。
Edge 的自监视连接为 OPC_SYSTEM_<edge_id>，由 Edge 通过同步直接声明 — 不在画面中创建。
输入小写字母会立即转换为大写，不允许的字符将被删除。
由 Edge 采集的连接（Edge 栏有填充的连接）的 协议 · 源 IP · 源端口 仅使用 Edge 的同步数据。 在画面中为只读。若为 Edge 采集协议但 Edge 尚未记录，则显示 「Edge 未确认」 徽章 — 待 Edge 下次同步后填充。
协议 — 可填值 (47种)
列表并非硬编码在画面中，而是从 mm_opc_protocol 表 中读取，该表的正本位于 plantpulse-event 的 协议目录 中 (CI 负责对照两者)。以下为基于目录的列表。
源类型 和 采集主体 (Edge / Platform) 由协议决定。
OPC (1)
| 值 | 说明 | 采集 |
|---|---|---|
OPCUA | OPC UA | Edge |
PLC (33)
| 值 | 说明 | 采集 |
|---|---|---|
AB-ETH | Allen-Bradley AB-Ethernet (CSP/PCCC, PLC-5/SLC-500) | Edge |
ADS | Beckhoff TwinCAT/ADS | Edge |
BACNET | BACnet/IP (HVAC/building automation) | Edge |
CANOPEN | CANopen (motion) | Edge |
CCLINK_IE | Mitsubishi CC-Link IE Field | Edge |
DALI | DALI (lighting) | Edge |
DELTAV | Emerson DeltaV (DCS) | Edge |
DNP3 | DNP3 (power/utility) | Edge |
EIP | Allen-Bradley EtherNet/IP | Edge |
FATEK | FATEK FBs | Edge |
FINS | OMRON FINS | Edge |
FOCAS | Fanuc FOCAS (CNC) | Edge |
GE | GE SRTP / PACSystems | Edge |
HART | HART-IP (4-20mA + digital) | Edge |
IEC104 | IEC 60870-5-104 telecontrol | Edge |
IEC61162_450 | IEC 61162-450 shipboard ethernet (NMEA over UDP) | Edge |
IEC61850 | IEC 61850 MMS (substation) | Edge |
IO_LINK | IO-Link (sensor master) | Edge |
KEYENCE_KV | Keyence KV series PLC | Edge |
KNXNET | KNXnet/IP (lighting/shading) | Edge |
LOGIX | Allen-Bradley ControlLogix/CompactLogix | Edge |
LS | LS ELECTRIC XGI/XBC/XBM | Edge |
MBUS | M-Bus (metering) | Edge |
MELSEC | Mitsubishi MELSEC | Edge |
MEWTOCOL | Panasonic MEWTOCOL | Edge |
MOTOR_SENSE | Motor Sense | Edge |
MTCONNECT | MTConnect machine tool data | Edge |
NMEA | NMEA 0183/2000 (marine) | Edge |
OP | Atlas Copco Open Protocol (tightening) | Edge |
PROFINET | Siemens PROFINET IO | Edge |
S7 | Siemens S7 | Edge |
SECSGEM | SECS/GEM (semiconductor fab) | Edge |
SNMP | SNMP network device polling | Edge |
Modbus (3)
| 值 | 说明 | 采集 |
|---|---|---|
MODBUS | Modbus TCP | Edge |
MODBUSUDP | Modbus UDP | Edge |
MODBUS_RTU | Modbus RTU (serial) | Edge |
数据库 (1)
| 值 | 说明 | 采集 |
|---|---|---|
POSTGRESQL | PostgreSQL | Platform |
消息队列 (7)
| 值 | 说明 | 采集 |
|---|---|---|
COAP | CoAP (RFC 7252) | Edge |
HTTP | HTTP push | Edge |
KAFKA | Apache Kafka | Edge |
MQTT_CLIENT | MQTT client | Edge |
ROS2 | ROS 2 (robot middleware) | Edge |
SPARKPLUG_B | Sparkplug B (MQTT) | Edge |
WEBSOCKET | WebSocket client | Edge |
API (1)
| 值 | 说明 | 采集 |
|---|---|---|
API | PlantPulse REST API | Platform |
系统 (1)
| 值 | 说明 | 采集 |
|---|---|---|
EDGE | PlantPulse Edge Gateway (self-monitor) | Edge |
新协议应先在 plantpulse-event 的协议目录中注册，并在 Platform 种子 (mm_opc_protocol) 中填入相同代码 — CI 会对照两者是否一致。但 出现在列表中并不代表可以采集 — 必须在 Edge 网关中存在能够实际通信的驱动。
请先在 Edge 协议指南 中确认支持情况。
保存后 — 已连接标签列表
表单下方始终设有 已连接标签列表 面板。但 仅在修改模式下列表才会填充 — 在新注册画面中显示为空格是正常的。
| 列 | 显示 |
|---|---|
| 选择 · 标签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 数据采集情况。"
| 数字 | 位置 | 功能 |
|---|---|---|
| ① | 右上角 | 站点选择器 与 搜索 |
| ② | 顶部面板 | Edge 可信度摘要 — 6张卡片 (详见下文) |
| ③ | 单张卡片 | 大数字 + 标签 + 一句话说明 |
| ④ | 列表头部 | 数量与 最后查询时间 |
| ⑤ | 表格头部 | 8个列 |
| ⑥ | 第一行 | 单台 Edge |
| ⑦ | 吞吐量格 | 当前速度(mps) · 累计数据点 · 24小时火花线图 |
| ⑧ | 操作格 | 详情 · 刷新 · 电源 · 日志 · 设置 · 查看可信度 |
Edge 可信度摘要 — 6张卡片
面板副标题为 「一览确认连接, PLC, 延迟, 资源状态」。 前三个计数 Edge 数量, 后三个计数 PLC 数量 — 单位不同，总计不一致是正常的。
| 卡片 | 计数对象 | 说明 |
|---|---|---|
| 全体 | Edge | 监测对象 Edge |
| 已连接 | Edge | Platform 可触达 |
| 连接断开 | Edge | Platform 不可触达 · 未观测 |
| PLC 正常 | PLC | 连接 + 采集均正常的 PLC 数量 |
| PLC 采集停止 | PLC | 已连接但未采集的 PLC 数量 |
| PLC 断开 | PLC | 已断开的 PLC 数量 — 需立即处理 |
查看可信度 — 单台 Edge 诊断
点击操作格(⑧)的 查看可信度 将在右侧打开抽屉。 其中包含一个 可信度 等级和 诊断项 列表。
| 诊断项 | 出现条件 |
|---|---|
| 断开的 PLC 连接数 | 至少存在一个断开的 PLC — 🔴 |
| (采集停止) | PLC 已连接但流入量为 0 — 🟡 |
| 无法触达的 Edge 数 | 连接断开(🔴)或从未观测到(🟡) |
| 系统错误 | 日志中的错误数 > 0 — 🟡 |
| 系统资源 | CPU · 内存 · 磁盘中任一达到 90% 以上 — 🟡 |
| 无异常迹象 | 不符合上述任何条件 — 🟢 |
确定等级(healthy / warning / critical) 的仅为 PLC 连接与采集。
连接断开 · 系统错误 · 资源 90% 超标仅作为诊断项 «显示», 并不改变等级。 因此可能会出现 「连接断开但可信度非 critical」 的组合 — 这并非故障，而是轴向分离的设计。请在查看等级的同时 参考诊断项。
「未观测» 并非故障，而是 尚未上传过数据 的状态。应确认 是否正确注册 而非立即处理。
过去存在延迟诊断项，但现在已删除。延迟异常以 数据源详情画面 的 今日最高延迟趋势 为准。
顶部工具
📡 엣지 [사이트 ▼] [검색] [↻]
| 控制项 | 宽度 | 说明 |
|---|---|---|
站点选择器 (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秒 | Platform 保存的 read-model (/edge/{id}/model) — Edge 约 60秒心跳上传的值 |
| 升级可能性确认 | 5分钟 | — |
系统资源仪表盘 · OPC 列表 · Docker 容器列表仅在进入画面时调用一次 Edge。之后仅在点击 ⚡ 实时刷新 时重新读取。 这是为了避免频繁请求设备。
因此，若长时间开启画面观察仪表盘，该值为进入时的快照值。 在现场采取措施后确认结果，请务必点击 ⚡。
连接 / 健康时间轴标签页
统计区域分为 2 个标签页。
| 标签页 | 内容 |
|---|---|
| 连接状态时间轴 (默认) | 过去 24 小时触达性 |
| 健康状态时间轴 | 过去 24 小时 PLC 连接 & 采集 |
健康时间轴在点击标签页可见时绘制。在打开标签页前显示为空格是正常的。
左侧 — 基本信息·主机·网络·安全 4面板
左侧 col-lg-3 区域纵向排列 4 个面板。均采用定义列表 (label / value) 格式。
① 基本信息 — 包含系统重启按钮
| 项目 | 含义 |
|---|---|
| Edge ID | 域 ID 徽章 (EDGE 域颜色) |
| 名称 | edge_name |
| 站点 | 站点 ID (域徽章) |
| 角色 | role (若无则显示 -) |
| 状态 | 主表 status 值 |
| 说明 | 备注 |
| 注册日 | Edge 首次注册时间 |
| 最近状态 | 最后接收到 heartbeat 的时间 |
面板页眉右侧设有 🔴 红色 ⏻ 电源图标按钮 — 点击重启 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 红色 |
| 内存使用率 | % | 同上 |
| 磁盘使用率 | % | 同上 |
数值显示至小数点后一位 (如: 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 | 🟢 CONNECTED / 🔴 其他 — 以点表示 |
| 采集 | 90px | 🟢 START / 🟡 其他 / ⚫ STOP — 以点表示 |
| 控制 | 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 容器 (远程部署·开始·停止·日志·删除)
每 5 秒更新一次运行在 Edge 主机 Docker 中的容器列表。
面板页眉
| 按钮 | 动作 |
|---|---|
| ↻ | 立即刷新 |
| ➕ 新建部署 | 容器部署对话框 (输入名称·镜像·端口·环境变量) |
列表表格 (6列)
| 列 | 宽度 | 显示 |
|---|---|---|
| 名称 | 160px | ▢ 立方体图标 + 容器名 (粗体) |
| 镜像 | 自动 | 镜像标签 (等宽字体, 如: grafana/grafana:latest) |
| 状态 | 80px | 🟢 UP / 🔴 DOWN 芯片 |
| 最近状态 | 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 守护进程接收并执行 image 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. 有个 Edge 的 CPU/内存 100%。 A. 请立即登录现场整理不必要进程。若问题重复出现，请考虑升级设备规格或调整采集周期。
Q. 点击卡片后出现空白画面。
A. 虽跳转至数据源详情画面(/connect/view)，但若无进入数据则看起来像空白画面。仅有数据进入历史的数据源才会显示丰富信息。
Q. 会实时自动更新吗？
A. [状态] 画面的卡片每分钟显示(_mm) 为自动更新。左侧统计图表按一定周期更新，若需立即生效请点击右上角 ↻ 刷新按钮。
Q. "接收数据点数量" 突然变成 0。 A. Edge 计数器重启后将从 0 开始。请结合 每日统计 画面的按站点数据量确认是实际 0 还是计数器重置。
Q. 在 Edge 详情画面(/edge/view) 中停止了 OPC 采集，但一段时间后又变回 START。
A. 并没有 「自动重启」 选项。原因仅有两种：
- Edge 采集器重启了 — 若连接中开启了 「自动开始采集»(
auto_collect)，采集器在 启动时 将该 OPC 设为 START。即使在画面中停止，下次启动后仍会变为 START。此项 仅在启动时刻 触发，不会在运行中定时复活 — 「一段时间后» 的本质是重启。关闭位置在 Edge 的 添加·编辑连接画面 复选框中。 - 外部进入了开始命令 — 任何人可通过
POST /api/v1/opc/{opcId}/start开启采集 (若已 START 则无动作)。请检查联动脚本或上级系统。
若需永久停止，请 关闭 「自动开始采集» 或禁用 OPC 本身 — 仅在画面中停止一次是不够的。
Q. Docker 容器面板为空。 A. ① Edge 可能未运行在 Docker 模式 — 部分 Edge 采用 systemd 直接启动。② Edge OS 的 Docker 守护进程可能无响应 (此时 ↻ 刷新依然为空)。请现场巡检或考虑 ⏻ 系统重启。
Q. 容器 ▶ 开始·🔄 重启·◼ 停止按钮全部显示。哪个是激活状态？ A. 所有按钮始终可点击 — 无论 Docker 状态如何都会发送命令。若已运行点击 ▶ 开始 可能会被忽略或导致重启，因此请观察 状态芯片 (🟢 UP / 🔴 DOWN) 选择预期命令。
Q. ⏻ 系统重启与 🔄 应用重启的区别？ A. ① 应用重启 (影响 10秒) — 仅重启 Edge 守护进程，OPC/PLC 采集中断 10秒。② 系统重启 (影响 1分) — 启动整个 Edge 主机 OS，Docker 容器随之重启。通常请始终先尝试应用重启。
Q. API Key 显示为掩码，如何确认实际值？ A. 掩码是刻意设计的 — 画面任何位置均不显示明文密钥。该键与 Flow REST 节点 的 X-API-Key 相同，请在首次发放时妥善保存。丢失请请求运营员重新发放。