跳到主要内容

日志分析

日志分析用于还原 PLC、通讯或 IDE 故障发生前后的事件。日志落在本机 IDE 或 Service 目录,不是集中式 SCADA 日志,也不做跨产线汇聚。现场问题不能稳定复现时,按时间、级别和模块过滤日志,比从文件开头逐行查找更有效。

日志入口​

优先打开 IDE 的 运行日志 面板。需要提供完整文件时,再到对应程序目录的 logs 文件夹取日志。

日志默认位置说明
IDE%AppData%\DarraPLC\logs编辑、编译、连接和界面事件
ServiceService 程序目录下 logs运行、通讯、部署和报警事件

日志级别​

级别含义排查用途
Trace高频细节仅受控复现时使用
Debug调试信息Debug 构建默认可见
Info正常状态变化启动、连接、保存、部署
Warn可恢复异常或退化重连、资源不足、配置回退
Error本次操作失败查同时间窗的前置 Warn
Fatal进程级严重故障优先定位并保留完整上下文

Release 构建默认从 Info 级开始;不要在生产现场长期打开 Trace 或 Debug。

分析步骤​

1. 确定时间窗​

记录故障发生时间,先取前后各 1 到 5 分钟。若设备时钟不一致,先记录每台设备当前时间偏差,不要直接把不同机器的日志按字符串排序。

2. 先看严重级别​

按 Fatal → Error → Warn 顺序筛选。第一条异常通常比后续重复错误更接近根因。

3. 按模块收窄​

在运行日志面板中选择模块或输入关键词,例如:

  • 项目保存、编译或部署;
  • DarraLink、MQTT、Modbus 或 OPC UA;
  • EtherCAT、WKC、AL Status;
  • Historian、磁盘或队列;
  • AI 请求、工具审批或模型连接。

模块名只用于缩小范围,最终以操作、时间和错误信息定位问题。

4. 阅读异常信息​

关注异常类型、消息、发生操作和堆栈最靠前的产品调用位置。不要只复制最后一行“操作失败”,也不要公开日志中的账号、令牌、设备证书或项目敏感数据。

5. 与状态和趋势对齐​

把第一条 Warn/Error 与以下信息对齐:

  • PLC 运行状态和扫描周期;
  • EtherCAT 从站状态与实际 WKC;
  • CPU、内存和磁盘变化;
  • 报警列表;
  • 工程师当时执行的操作。

常见现象​

现象先检查下一步
IDE 打不开IDE logs 中最早的 Error/Fatal保留日志并检查当前布局与依赖
Service 未连接Service 是否启动、18821 是否可达查看 Service 同时间窗错误
MQTT 未发送连接状态、上行映射、离线队列查看最后错误和丢弃计数
Modbus 超时IP/串口、站号、超时参数对照设备手册核对地址
Historian 无数据是否有数值变量、存储是否可写;Historian 仅 L1-2 短期查看 Historian 与磁盘警告
EtherCAT 状态异常首个异常从站、AL 状态、WKC进入网络诊断

提供给支持人员的材料​

  • 故障时间与时区;
  • IDE 和 Service 日志文件;
  • 当前 Profile、设备型号和项目版本;
  • 诊断面板中相关状态截图;
  • 故障前后执行过的操作;
  • 日志中敏感字段已脱敏的副本。

相关文档​