Device Logs

Synchronized Device Documentation

This page corresponds to the synchronized Chinese source. Commands, JSON examples, API paths, field names, and screenshots are kept aligned with the Chinese device-side source documentation.

What This Page Covers

• Web console page purpose and related device-side configuration model.
• Available fields, operational workflow, and safety checks.
• Validation steps, logs, and maintenance recommendations.

Source Reference

The detailed operational source is preserved below so implementation details stay exact while the English navigation, titles, and reading path remain available.

设备日志

概述: 设备日志模块提供系统健康监控和运行时日志查看功能,包括内存/WiFi/MQTT 状态监控、告警阈值设置、日志级别调整(仅 full 版)。HealthMonitor 每 5 秒检查一次堆内存,低于阈值时自动降级服务并记录 WARN 日志。

功能说明

设备日志页面用于查看系统运行日志，帮助诊断问题和监控设备状态。支持不同日志级别和实时日志流。

设备日志页面

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

现场故障排查决策树

操作指南

1. 进入 设备日志 页面
2. 查看实时日志输出
3. 可按级别筛选日志
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 级别
看不到日志	WebSocket 未连接	刷新页面
日志时间错误	NTP 未同步	检查网络和 NTP 配置
内存中断	日志缓冲区满	定期清除或降低日志级别