设备日志
设备日志页面读取 LittleFS 中的日志文件,支持选择文件、刷新和清空。先在“功能配置”启用日志查看与文件日志组合并按提示重启。健康指标和保护阈值见健康监控,本页不提供告警阈值设置。
功能说明
页面进入或点击刷新时请求日志列表和内容,不提供 WebSocket 或 SSE 日志流,也没有按级别筛选按钮。日志级别在设备配置中设置;发布编译还可能裁剪 INFO/DEBUG 调用,运行时调高级别不能恢复已裁剪的日志。

排障时优先观察启动、网络、MQTT、外设初始化和内存告警相关日志;修改日志级别后注意再切回适合现场运行的级别。
操作指南
- 进入 设备日志 页面
- 选择日志文件,查看本次读取的内容和大小
- 需要更新时点击刷新;页面一次请求末尾 180 行、最多 4096 字节,留意截断提示
- 支持清除历史日志
参数说明
日志级别
| 级别 | 说明 | 示例 |
|---|---|---|
| ERROR | 错误信息 | 外设初始化失败、内存不足 |
| WARNING | 警告信息 | WiFi 信号弱、传感器读取超时 |
| INFO | 一般信息 | 设备启动、WiFi 连接成功 |
| DEBUG | 调试信息 | GPIO 状态变化、规则执行详情 |
日志格式
[时间戳] [级别] [模块] 消息内容示例:
[12:30:45] [INFO] [WiFi] Connected to SSID: MyRouter, IP: 192.168.1.100
[12:30:46] [INFO] [MQTT] Connected to broker
[12:31:00] [DEBUG] [PeriphExec] Rule "LED闪烁" triggered
[12:31:05] [WARNING] [Sensor] DHT11 read timeout配置示例
修改日志级别
在 设备配置 中设置日志级别:
- ERROR:仅显示错误(生产环境推荐)
- INFO:显示正常运行信息(默认)
- DEBUG:显示所有详细信息(调试时使用)
故障排除
| 问题 | 可能原因 | 解决方案 |
|---|---|---|
| 日志刷新太快 | DEBUG 级别信息过多 | 切换到 INFO 或 WARNING 级别 |
| 看不到日志 | 功能关闭、无日志文件或读取失败 | 核对功能状态、请求错误和文件日志设置,再手动刷新 |
| 日志时间错误 | NTP 未同步 | 检查网络和 NTP 配置 |
| 返回 503 | 内部 DRAM 不足或读取任务繁忙 | 按接口提示等待,减少并发并保留诊断证据;不要连续清空日志掩盖问题 |
清空只影响选中的日志文件,执行前保留需要的排障记录。读取成功和日志 worker 入队都不证明近期业务已成功;写盘故障、保护状态及实物结果须另行核对。

