跳到主要内容

故障排查

按症状快速定位并解决问题。

容器模式提示框

systemctl is-active plantpulse-edge.service 为 active 时即为容器模式 —— 部分症状可参考 容器模式运维指南 的"故障处理"一节，或容器内 /opt/kopens/install/RUNBOOK.md 的场景矩阵 (A~E)，可更快完成诊断。批量采集诊断信息：

sudo bash /opt/kopens/install/bin/doctor.sh
# → /tmp/pe-doctor-`<host>`-`<ts>`.tar.zst (support 전달)

快速索引​

症状前往
网关页面打不开页面打不开
无法登录无法登录
无法连接 (PLC)无法连接
已连接但没有数据没有数据
有数据但数值异常数值异常
数据突然中断数据突然中断
页面很慢页面很慢
内存/磁盘显示红色资源不足
无法向云端 / SCADA 传输数据无法传输
标签 [写入] 失败无法写入数值

页面打不开​

在浏览器中输入网关 IP 后页面无法显示的情况。

第 1 步 —— 确认 PC 能否访问网关​

在命令提示符中执行：

ping <gateway-ip>

若无响应，则是网络 / 线缆 / VPN 问题。请告知系统管理员"无法访问网关"。

第 2 步 —— 尝试其他浏览器 / 用户​

若在其他 PC 上也出现同样症状，可能是网关本身已关闭或停止运行。需由系统管理员重启网关 PC。

第 3 步 —— 确认 URL​

  • http://게이트웨이IP/ 是常见格式。
  • 也有带端口号的情况 (例如：http://게이트웨이IP:8080/)。
  • 如不清楚公司标准 URL，请向同事确认。

无法登录​

忘记密码​

请尝试使用默认密码。

  • ID: admin
  • 密码: admin123!

若环境中密码已被修改，请向系统管理员申请重置密码。

登录后立即被退出​

可能是会话 / Cookie 问题。请清除浏览器 Cookie 后重试。

无法连接​

[连接] 页面显示红色"连接失败"的情况。

第 1 步 —— 同一台 PC 能否访问 PLC​

请让系统管理员在网关 PC 上确认能否 ping 通 PLC IP。

第 2 步 —— 端口是否正确​

各类 PLC 的默认端口：

PLC端口
OPC-UA (Kepware)49320
Modbus TCP502
三菱 (Q/L)5000 或 1029 (PLC 设定值)
三菱 (iQ-R)1500
西门子 S7102
LS2004
AB EtherNet/IP44818

PLC 侧的通信模块必须已启用。

第 3 步 —— PLC 侧安全设置​

PLC所需附加设置
西门子 S7在 TIA Portal 中启用"允许 PUT/GET 通信" + 关闭 DB 的 Optimized 模式
三菱在 GX Works 中启用"MC 协议 / TCP / 端口"
OPC-UA允许用户名 / 密码或匿名接入
LS确保 ICMP (ping) 未被阻断

第 4 步 —— 用户名 / 密码​

对于 OPC-UA 这类带认证的 PLC，ID / 密码必须准确。请在 PLC 的 [修改] 表单中重新输入后再试。

没有数据​

连接显示"连接正常"，但标签的 [当前值] 栏为空的情况。

第 1 步 —— 确认 PLC 地址表示法​

这是最常见的原因。不同类型 PLC 的地址表示法不同。

  • 三菱：D100、M50 (前面没有 %)
  • 西门子：%DB1.DBW0 (前面带 %，DB 编号 + DBW/DBD)
  • LS：D00309 (5 位数字)
  • OPC-UA：ns=2;s=경로 格式

请重新查看对应 PLC 页面的 [PLC 地址表示法] 一节。

第 2 步 —— 确认数据类型 / 类型辅助设置​

若数值为 32 位以上，而 [类型辅助] 为空，则会被误按 16 位读取，导致数值不显示。

  • 32 位整数：类型辅助 = DW
  • 32 位浮点数：类型辅助 = REAL
  • 64 位浮点数：类型辅助 = LREAL

第 3 步 —— 用其他工具验证同一地址​

请在 PLC 编程工具 (GX Works / TIA Portal / XG5000 / UA Expert) 的监视 / Watch 界面中确认该地址是否确实有效。

数值异常​

有数据但数值过大、过小或符号相反的情况。

32 位数据被按 16 位读取​

表现为数值随机跳变或一侧被截断。请在 [类型辅助] 中指定 DW (整数) 或 REAL (浮点数)。

无符号数值被按有符号读取​

例如：65535 显示为 -1。请在 [类型辅助] 中指定 UI (16 位无符号) 或 UDW (32 位无符号)。

byte / word 顺序 (endian) 相反​

某些从站 (Modbus 从站中常见) 以 little-endian 发送数值时，32 位浮点数会显示错乱。

  • 若为 Modbus，可尝试 :UDINT_LSWORD_FIRST 之类的数据类型变体
  • 其他 PLC 有时难以通过 应用计算公式 做后处理，请咨询系统管理员

单位不一致​

PLC 发送整数原始值 (例如 1638)，而实际含义为 163.8 的情况。可通过 应用计算公式 输入 ${VALUE}*0.1 进行单位换算。

数据突然中断​

原本正常采集的数值在某一时刻起不再更新的情况。

第 1 步 —— 确认连接状态​

在 [连接] 菜单中查看该 PLC 的连接状态如何？

状态含义 / 后续操作
红色"连接失败"PLC 侧存在问题。重启 PLC 或检查线缆 / 网络
灰色"停止"有人点击了 [停止] 或自动停止。点击 [启动] 按钮恢复
绿色"连接正常" + 仅无数据可能该 PLC 地址已被停用

第 2 步 —— PLC 自身巡检​

  • PLC 是否处于 RUN 模式 (若切换到 STOP，数值会停止更新)
  • 该地址区域的内存保护设置是否被修改
  • 若刚完成 PLC 固件升级 / 重启，稍等片刻会自动重新连接

第 3 步 —— 重启网关​

通过 [设置] → [重启应用程序] 重新启动网关本身，通常 1 分钟内恢复。

页面很慢​

当 PLC 数量或标签数量过多时，首次加载可能会延迟 1~2 秒。

  • 一般情况下不是大问题。
  • 若主页面的 CPU 仪表盘显示红色，可能是网关 PC 资源不足。请咨询系统管理员。

资源不足​

主页面的 CPU / 内存 / 磁盘仪表盘显示红色的情况。

仪表盘处理方法
CPU确认是否有 PLC 使用了过短的采集周期。请调整为 1 秒以上
内存可通过 [设置] → [重启应用程序] 暂时缓解。若反复出现，请向系统管理员申请扩容内存
磁盘[设置] → [清理临时文件]。也可能是时序数据保留周期设置过长

无法传输​

数据采集正常，但无法传送到云端 / SCADA / MQTT 的情况。

MQTT / Sparkplug 未发布​

  • 请系统管理员确认"MQTT 是否已启用"
  • 确认同一台网关 PC 上的 MQTT 代理 (HiveMQ 等) 是否正在运行

平台 API 无响应​

  • 无法接入 PlantPulse 平台本身 → 请联系总部 / 运维团队
  • 网关自身会将数据缓存在队列中，短时中断可自动恢复。

面向系统管理员的详细日志关键字 / 日志位置请参阅"高级 —— 开发者笔记"。

最后手段​

  • [设置] → [下载日志] 批量下载诊断日志
  • [设置] → [重启应用程序] 仅重启网关 (1 分钟)
  • [设置] → [系统重启] 重启 PC 本身 (3~5 分钟)

若仍无法解决，请附上下载的日志联系 KOPENS 或 PlantPulse 运维团队。

无法写入数值​

点击标签行末尾的 [写入] 图标后出现"写入失败" / "driver returned false"等消息的情况。

各协议的写入支持情况​

写入支持与否因 PLC 类型而异。

您使用的 PLC写入支持备注
三菱 (MELSEC)✅ 支持Q/L/iQ-R 均支持
西门子 (S7)✅ 支持DB/M/I/Q 区域
OPC-UA (Kepware 等)✅ 支持目标节点需具备 Write 权限
Modbus TCP✅ 支持Holding Register / Coil
HTTP 推送✅ 支持 (缓存)—
LS ELECTRIC (XGI/XBC/XBM)✅ 支持Bit/Byte/Word/DWord/Float/Double
AB EtherNet/IP✅ 支持视 PLC 固件/补丁版本，部分类型可能被拒绝

常见消息​

消息含义 / 处理方法
쓰기 실패 (opc_type=...)驱动返回 false。请检查地址格式、数据类型 (format)、PLC 的 Write 权限
tag not found: ...标签 ID 错误。刷新后重试
scheduler not running for opc_id=...该 PLC 处于 [停止] 状态。点击 [启动] 按钮后重试
OPC ... 가 PLC 와 연결되어 있지 않습니다在 DISCONNECTED 状态下尝试写入 —— 确认 IP/端口/防火墙后重启

如仍无法解决​

  • 请将 [PLC 类型 + 标签 ID + 完整消息] 告知系统管理员。
  • 可在网关日志中查看更详细的原因。