设备管理

设备台账（菜单：设备运维 → 设备台账）是设备资产的中枢，覆盖设备的建档、信息维护、令牌管理与生命周期操作。本章聚焦日常管理操作；接入与数据上报见《快速上手》与《设备接入开发指南》。

操作角色：租户管理员拥有全部操作权限；客户用户只读，仅能看到分配给自己的设备。

一、设备列表

列表按行展示每台设备的关键信息：

列	含义
设备名称	建档时的名称，支持搜索
外部 ID	子设备在网关侧的标识，直连设备可能为空
设备类型	普通设备 / 网关设备
所属网关	子设备显示其挂载的网关，直连设备为空
状态	在线 / 离线，实时反映 MQTT 连接状态
最后连接	最近一次建立连接的时间
最后活跃	最近一次上报数据的时间

筛选技巧：顶部的关键字搜索支持名称与外部 ID；排查"不活跃设备"时，按最后活跃时间排序，长期未上报的设备一眼可见。

二、设备详情页

点击设备名称进入详情页，页面分为几个区域：

信息横幅

设备名称、在线状态、设备 ID、外部 ID、所属网关、最后上报时间一目了然，访问令牌也在这里查看与复制。

实时数据

展示该设备各遥测属性的最新值：指标名、当前值、数据类型与各自的上报时间。开启自动刷新开关后，每 5 秒拉取一次最新值。

注意：每个属性的时间戳是各自独立的——设备常常一条报文报多个字段，但如果某字段长期不报，它的"最后更新时间"会明显落后于其他字段，这属于正常现象。

历史数据

按时间区间查询遥测历史曲线：

• 指标选择：单次可勾选 1~5 个字段；
• 时间范围：任意起止时间；
• 间隔与聚合：数据量大时选择降采样窗口（如 10 分钟）与聚合方式（平均值/最大/最小等），曲线更平滑、加载更快；不选则返回原始数据点。

客户端属性 / 服务端属性

属性是设备的"状态标签"，与遥测的区别：属性只保留每个字段的最新一个值，适合存放型号、版本、位置等低频变化的信息。客户端属性来自设备上报（v1/devices/me/attributes），服务端属性由平台侧维护。

三、修改与删除设备

编辑设备

可修改设备名称、外部 ID、网关归属。两个注意点：

• 外部 ID 不要随意改：网关按外部 ID 匹配数据，改了之后网关报文会对不上新 ID，数据开始丢失；
• 网关归属变更：把设备从网关 A 挪到网关 B，需要同步调整边缘侧的设备标识配置。

删除设备

删除是不可恢复的操作，删除后：

• 设备的连接会立即被平台断开；
• 设备档案随之移除，无法再查看其详情。

如果设备产生的遥测数据还需要保留查询，请先在设备详情页确认数据已导出或不再需要。网关设备删除前，建议先处理其子设备的归属。

四、常见问题

现象	排查方向
设备显示在线但"最后活跃"很旧	连接还在但已停止上报；检查设备端程序是否卡住
在线状态和实际不符	检查是否多台设备共用令牌互相顶线；或网络断开在超时判定之前
删除设备提示失败	设备存在未完成的关联（如子设备仍挂在其下），先处理子设备
令牌泄露了怎么办	编辑设备重新生成令牌，并同步更新设备端配置

---

下一步：设备数据的告警配置与处理，请看《告警规则》与《告警中心》。