Skip to content

设备日志 ​

设备日志页面读取 LittleFS 中的日志文件,支持选择文件、刷新和清空。先在“功能配置”启用日志查看与文件日志组合并按提示重启。健康指标和保护阈值见健康监控,本页不提供告警阈值设置。

功能说明 ​

页面进入或点击刷新时请求日志列表和内容,不提供 WebSocket 或 SSE 日志流,也没有按级别筛选按钮。日志级别在设备配置中设置;发布编译还可能裁剪 INFO/DEBUG 调用,运行时调高级别不能恢复已裁剪的日志。

设备日志页面

排障时优先观察启动、网络、MQTT、外设初始化和内存告警相关日志;修改日志级别后注意再切回适合现场运行的级别。

操作指南 ​

  1. 进入 设备日志 页面
  2. 选择日志文件,查看本次读取的内容和大小
  3. 需要更新时点击刷新;页面一次请求末尾 180 行、最多 4096 字节,留意截断提示
  4. 支持清除历史日志

参数说明 ​

日志级别 ​

级别说明示例
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 入队都不证明近期业务已成功;写盘故障、保护状态及实物结果须另行核对。

蜂信物联 | fastbee.cn