设备轨迹查询
当设备的状态出现异常时,您可以使用设备轨迹查询(又称“日志拉取”)功能查询设备的连接历史,快速排查设备离线问题,定位异常原因。
操作步骤
登录云消息队列 MQTT 版控制台,并在左侧导航栏单击实例列表。
在顶部菜单栏选择目标地域,然后在实例列表中单击实例名称进入实例详情页面。
在实例列表中找到目标实例,在其操作列中,选择。
在设备轨迹查询页面,设置Group ID、Device 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连接断开。
时间
设备动作发生的时间。
查询结果为空时的排查
查询结果为空,说明设备在所选时间范围内没有连接记录。按以下步骤排查:
确认设备是否发起过连接请求:通过规则管理订阅上下线通知,实时监控设备连接状态。
检查设备端网络:确认设备能访问 MQTT 接入点域名,检查防火墙是否放行。
检查认证信息:确认 Token 或证书是否过期或配置错误。
检查重连逻辑:确认设备的重连间隔和最大重试次数。
确认时间范围:时间范围最大跨度为 1 天,确认覆盖设备可能的连接时段。
相关文档
如果需要查询设备的状态,请参见设备状态查询。