物联网平台的日志服务提供查看设备通信消息轨迹功能。您可根据TraceID或MessageId，追踪任意一条消息在物联网平台流转的全路径，还可根据出现的故障节点快速分析、定位问题。本文介绍查看消息轨迹的操作步骤。

限制说明

仅中国地域的企业版实例和新版公共实例，支持使用消息轨迹功能。

操作步骤

  1. 登录物联网平台控制台。
  2. 在实例概览页面，找到对应的实例，单击实例进入实例详情页面。
    注意 目前华东2（上海）、华北2（北京）、华南1（深圳）地域开通了企业版实例服务。其他地域，请跳过此步骤。
    实例概览
  3. 在左侧导航栏，单击监控运维 > 日志服务，在云端运行日志页签，找到要查看消息轨迹的TraceID或MessageId。
  4. 单击消息轨迹，在搜索框中，输入TraceID或MessageId。
  5. 单击右侧搜索图标搜索，查看消息轨迹图。
    • 消息轨迹图由通信节点图标和连接线组成。图示显绿色，表示通信流成功；显红色，表示失败。
    • 鼠标指针移动到通信节点，可查看通信流时间、成功信息或失败原因等。
    例如，针对家庭温控器产品上报数据，设置了流转规则如下：

    处理数据的SQL语句：

    SELECT 
items.temperature.value as temperature, 
items.humidity.value as humidity,
deviceName() as deviceName,
timestamp() as time 
FROM "/g***/TH_sensor/thing/event/property/post"

    转发temperature、humidity、deviceName、time的数据：

    • 将数据插入到表格存储（Tablestore）中：主键设置为${deviceName}。
    • 将数据发布到AMQP服务端订阅消费组：默认消费组。
    • 将数据存储到实例内时间序列数据库中：metric数据类型选择数值型。
    • 将数据插入到云数据库（RDS）中：数据库表中字段time已设置为主键自增长。
    • 将数据发布到另一个Topic中：/g***/TH_sensor/user/update。

    具体操作，请参见设置数据流转规则。

    如下图所示，设备上报数据后，查看消息轨迹，可发现在数据流转操作中：

    • 发布到另一个Topic（republish）、插入到表格存储（ots）和发布到AMQP服务端订阅消费组的消息处理成功。
    • 存储到实例内时间序列数据库（tsdb in vpc）因参数非法，及插入到云数据库（rds）中因云产品配置异常，都导致消息处理失败。
    消息示例

后续步骤

当您在通信轨迹中发现有处理失败节点时，需根据失败原因，进行排查和修复。排查方法，请参见云端运行日志中各错误码说明。

如上文示例轨迹图，您可前往规则引擎 > 云产品流转页面，找到ruleName对应的流转规则，针对失败的转发操作，进行修正：

  • 将数据存储到实例内时间序列数据库中：metric数据类型改为字符串。
  • 将数据插入到云数据库（RDS）中：取消数据库表中字段time的主键设置。

如图所示，设备再次上报数据后，查看消息轨迹，消息处理成功。

消息轨迹