跳至主要內容

日志和统计

约 1722 字大约 6 分钟

日志和统计

ThingsCloud 为每个自动化和场景提供完整的日志记录和统计分析功能，帮助您了解执行情况、排查问题、优化配置。

日志与统计的作用

  • 日志 —— 记录每次执行的详细过程，便于排查问题和验证结果。
  • 统计 —— 展示执行趋势和指标，帮助分析运行状况和优化配置。

日志功能

日志功能记录自动化或场景每次执行的完整过程，包括触发时间、执行耗时、每个动作的执行状态和详细信息。

开启日志记录

默认情况下，日志记录处于关闭状态。如需记录执行日志，请手动开启：

  1. 进入自动化或场景详情页。
  2. 切换到日志。
  3. 打开调试状态开关。

注意

  • 开启调试状态后，将记录运行日志，包括运行错误信息，便于调试触发器、条件和动作。
  • 日志仅用于调试，最多保存 7 天。
  • 建议只在调试阶段或关键自动化/场景开启日志。

日志内容详解

运行记录列表

每次自动化或场景执行完毕后，会产生一条运行记录，包含以下信息：

  • 执行时间 —— 自动化被触发或场景被执行的具体时间。
  • 执行耗时 —— 从开始到结束的总耗时。
  • 触发器类型 —— 自动化的触发方式。
  • 执行状态 —— 本次执行的整体结果。

执行状态说明：

状态含义说明
✅ 完成所有动作正常执行完毕执行流程正常结束
❌ 失败某个动作执行失败根据失败策略可能中断或继续
⚠️ 终止执行被强制终止并发策略设置为"终止前次"时触发
⏭️ 跳过未执行任何动作并发策略设置为"放弃本次"时触发
🚫 条件不满足条件检查未通过触发后条件判断失败，动作未执行

执行时间线

点击运行记录可展开查看详细的执行时间线，以可视化方式展示执行过程，例如：

🟢 开始执行 —— 08:00:00
    ↓
🟡 条件检查 —— 08:00:00（时间范围检查通过）
    ↓
🟢 属性下发 —— 08:00:01（设备：灌溉阀门，属性：开关=ON）
    ↓
🟢 延迟等待 —— 08:00:01（等待 10 分钟）
    ↓
🟢 属性下发 —— 08:10:01（设备：灌溉阀门，属性：开关=OFF）
    ↓
🟢 执行完成 —— 08:10:02

节点状态标识：

  • 🟢 成功 —— 该步骤正常执行完成。
  • 🔴 失败 —— 该步骤执行失败，可查看错误详情。
  • 🟡 警告 —— 该步骤执行完成但有警告。
  • ⚪ 跳过 —— 该步骤被跳过未执行。

动作详情

每个动作节点会显示详细的执行信息：

属性下发/属性更新：

  • 目标设备名称。
  • 设置的属性及值（如：开关=ON, 温度=26）。

执行任务：

  • 目标设备名称。
  • 执行的任务名称（如：重启设备、查询状态）。

执行场景：

  • 执行的场景名称。
  • 是否等待场景执行完成。

延迟等待：

  • 延迟时长（如：10 分钟）。

错误信息

当动作执行失败时，时间线会显示详细的错误信息，常见的错误信息如下：

  • 属性下发失败 —— 向设备下发属性时出错。
  • 属性更新失败 —— 更新云端属性时出错。
  • 属性格式无效 —— 属性值格式不符合要求。
  • 属性不符合功能定义 —— 属性值不符合设备类型中的功能定义。
  • 设备不存在 —— 动作中指定的设备已被删除或不存在。
  • 设备消息频率过高，请稍后再试 —— 设备消息发送频率超过限制。
  • 设备日消息数达到上限 —— 设备当日消息数量达到上限。
  • 场景执行失败 —— 执行场景时发生错误。
  • 场景已被禁用 —— 要执行的场景已被停用。
  • 场景不存在 —— 动作中指定的场景已被删除或不存在。

刷新日志

点击刷新按钮可获取最新的执行记录。

清空日志

点击清空日志按钮可删除所有历史日志记录。清空后无法恢复，请谨慎操作。

统计功能

统计功能提供自动化和场景的执行数据分析和可视化展示，帮助您了解运行趋势和关键指标。

总体统计

在统计页面顶部，显示以下汇总指标：

  • 执行次数：累计执行的总次数。
  • 上次执行时间：最近一次执行的时间。

触发器统计趋势图

展示不同类型的触发器触发次数的分布和趋势，关于触发器的种类和定义，请参考触发器。

通过触发器统计趋势图，您可以：

  • 了解自动化的主要触发来源。
  • 分析触发频率是否合理。
  • 发现异常触发模式。

执行统计趋势图

展示每次执行的结果分布和趋势，可用于：

  • 监控执行成功率。
  • 发现执行失败的时间规律。
  • 评估并发策略的合理性。

动作调用统计趋势图

展示各类动作的调用次数分布和趋势，关于动作的种类和定义，请参考动作。

通过动作调用统计趋势图，您可以：

  • 了解自动化对各动作的使用频率。
  • 分析动作调用的时序分布。
  • 评估动作配置的合理性。

导出数据

点击统计趋势图上方的导出按钮，可将图表数据导出为 Excel 文件，包含：

  • 时间戳
  • 各统计指标的数值

导出的文件可用于：

  • 离线分析
  • 生成自定义报表
  • 数据备份

常见问题

Q：为什么日志中没有记录？

A：请检查：

  1. 是否已开启日志记录开关。
  2. 自动化/场景是否已被触发或执行完毕，若包含延迟动作，可能需要等待一段时间后再查看日志。
  3. 是否已经超过日志保存期限（7 天），过期日志会被自动清除。

Q：执行状态"条件不满足"是什么意思？

A：表示自动化已被触发，但条件检查未通过，因此动作未执行。这通常是正常现象，说明条件过滤起了作用。

Q：统计数据多久更新一次？

A：统计数据实时更新，但图表数据可能存在 1-2 分钟的延迟。如需最新数据，可点击刷新按钮。

Q：可以导出多长时间的统计数据？

A：目前支持导出最近 30 天的统计数据。如需更长时间的历史数据，建议定期导出保存。

ThingsCloud
Copyright © 2026 ThingsCloud