日志分析
日志分析用于还原 PLC、通讯或 IDE 故障发生前后的事件。日志落在本机 IDE 或 Service 目录,不是集中式 SCADA 日志,也不做跨产线汇聚。现场问题不能稳定复现时,按时间、级别和模块过滤日志,比从文件开头逐行查找更有效。
日志入口
优先打开 IDE 的 运行日志 面板。需要提供完整文件时,再到对应程序目录的 logs 文件夹取日志。
| 日志 | 默认位置 | 说明 |
|---|---|---|
| IDE | %AppData%\DarraPLC\logs | 编辑、编译、连接和界面事件 |
| Service | Service 程序目录下 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、设备型号和项目版本;
- 诊断面板中相关状态截图;
- 故障前后执行过的操作;
- 日志中敏感字段已脱敏的副本。