设备轨迹查询

更新时间:
复制 MD 格式

当设备的状态出现异常时,您可以使用设备轨迹查询(又称“日志拉取”)功能查询设备的连接历史,快速排查设备离线问题,定位异常原因。

操作步骤

  1. 登录云消息队列 MQTT 版控制台,并在左侧导航栏单击实例列表

  2. 在顶部菜单栏选择目标地域,然后在实例列表中单击实例名称进入实例详情页面。

  3. 在实例列表中找到目标实例,在其操作列中,选择更多 > 设备轨迹查询

  4. 设备轨迹查询页面,设置Group IDDevice ID时间范围,然后单击查询

    说明

    时间范围的最大跨度为1天。

    字段

    说明

    Channel ID

    设备连接标识。

    设备动作

    • connect:客户端请求与服务端连接。

    • close:TCP连接断开。

    • disconnect:客户端请求断开与服务端的连接。

    动作说明

    • accepted:服务端接收客户端发起的连接请求。

    • not authorized:客户端访问的实例权限校验失败导致TCP连接断开。

    • clientId conflict:客户端标识冲突导致TCP连接断开。

    • topic auth failed:客户端访问的Topic资源权限校验失败导致TCP连接断开。

    • no heart:客户端无心跳导致TCP连接断开。

    • closed by client:客户端异常导致TCP连接断开。

      说明

      客户端没有发送disconnect报文。常见触发场景:客户端进程崩溃或被强制终止(如 kill -9)、MQTT SDK 内部异常导致TCP连接异常关闭。排查时检查客户端日志确认断开时间点,确认客户端进程状态是否异常退出。

    • Socket IOException:网络抖动或丢包导致TCP连接断开。常见触发场景:客户端本地网络闪断、防火墙或代理服务器阻断MQTT连接。排查时检查客户端网络连通性,确认本地防火墙和安全组规则放行MQTT端口(1883/8883)。

    • invalid param:请求参数不合法导致TCP连接断开。

    • disconnected by client:客户端请求断开连接。

    • ServerShutdown:服务端升级或服务端宕机造成的TCP连接断开。

    时间

    设备动作发生的时间。

查询结果为空时的排查

查询结果为空,说明设备在所选时间范围内没有连接记录。按以下步骤排查:

  1. 确认设备是否发起过连接请求:通过规则管理订阅上下线通知,实时监控设备连接状态。

  2. 检查设备端网络:确认设备能访问 MQTT 接入点域名,检查防火墙是否放行。

  3. 检查认证信息:确认 Token 或证书是否过期或配置错误。

  4. 检查重连逻辑:确认设备的重连间隔和最大重试次数。

  5. 确认时间范围:时间范围最大跨度为 1 天,确认覆盖设备可能的连接时段。

相关文档

如果需要查询设备的状态,请参见设备状态查询