设备管理（数采）¶
适用基线：测试环境目标 /
dev分支 / 2026-07-15。 阅读对象：测试、实施、运维（主）；设备/自动化工程师（顺带）。操作见设备管理-维护与查询参考。
业务目的与适用范围¶
设备启用了、参数也打开了采集，日志却还是空的——这类问题需要按「设备 → 参数 → 边缘 → MQTT」一层层排查。本组覆盖数采侧的设备主档、采集结果查询与 MQTT 链路监控：
- 设备管理（采集数据资产）：维护参与采集的设备编码、名称、类别与启用状态。
- 采集日志：查询参数采集时序（设备、参数、采集点、值、客户端等）。
- MQTT 客户端监控：查看客户端在线状态与上下线时间。
名称中的「设备」指数采资产，与 DBC「设备台账」、EAM「维修对象」可能编码对齐，但页面与数据对象独立，未证实自动同步。读完本页，应能分清「这个设备」到底是数采资产、DBC 台账还是 EAM 维修对象，并知道无日志时先查哪一层。
如何使用本组文档¶
| 你的目的 | 建议阅读 |
|---|---|
| 想理解设备—日志—MQTT 关系 | 本页：准备 → 主路径 → 关键判断 → 验证点 |
| 弄清无数据时怎么分层排查 | 本页「写实示例」「建议验证点」 |
| 正在建档设备或查日志 | 设备管理-维护与查询参考 |
| 想配采集点与参数项 | 采集点 |
| 想看消费侧如何用读数 | 数采与边缘接入模型、MES 点检相关页 |
使用前准备¶
下面几项没配齐，日志大概率长期为空：
| 需要确认什么 | 为什么重要 |
|---|---|
| 采集点与参数项已配且打开采集 | 否则日志长期为空 |
设备类别字典（iot_asset_type） |
建档分类 |
| MQTT/边缘客户端约定 | 监控与日志中的客户端 ID 才有意义 |
在线状态字典（iot_client_link_staus） |
筛选在线/离线 |
📷 截图占位
采集设备列表（编码、类别、启用）与采集日志一行样例。
对象与主路径¶
flowchart LR
A["建采集设备并启用"] --> B["配参数并打开采集"]
B --> C["边缘/MQTT 上报"]
C --> D["采集日志可查"]
E["MQTT 客户端监控"] -.-> C
| 对象 | 关键业务字段（已从前端取证） | 使用者关心 |
|---|---|---|
| 采集设备 | 设备编码、名称、类别、状态（启用/不启用） | 是否启用、编码是否与现场一致 |
| 参数采集日志 | 设备编码、参数编码、采集点、采集值、采集时间、客户端 ID、参数类型等 | 有没有值、值对不对、哪个客户端上报 |
| MQTT 客户端状态 | 客户端 ID、在线状态、上线/下线时间、用户名等 | 链路是否断 |
写实示例：给定配置 → 期望行为
给定： 设备 DEV-01 已启用；参数已打开采集且分区对齐；MQTT 客户端在线并按约定上报。
期望： 采集日志可按设备编码查到近期值；客户端 ID 可与 MQTT 监控对照。若设备未启用或 MQTT 长期离线，日志为空时先分层排除，不要先改 MES 点检单据。
状态与关键动作¶
| 对象 | 常见动作 | 说明 |
|---|---|---|
| 采集设备 | 新增/编辑/删除/导出 | 状态开关：启用 0 / 不启用 1（以页面开关为准） |
| 采集日志 | 查询、导出；表单能力以页面为准 | 日志以查询为主，勿当业务单据改库存 |
| MQTT 监控 | 查询、导出；新增入口可能隐藏 | 偏运维监控 |
关键判断¶
| 判断点 | 应先确认什么 | 影响 |
|---|---|---|
| 设备启用仍无日志 | 参数采集开关、分区、边缘进程、MQTT 在线 | 分层排查 |
| 日志有值业务读不到 | MES/WMS 是否走网关 RPC、编码是否一致 | 消费侧问题 |
| MQTT 长期离线 | 客户端认证、网络、Broker | 上报中断 |
| 与 DBC 台账对不上 | 是否约定同一编码体系 | 跨模块联查失败 |
建议验证点¶
- 新建并启用一台采集设备；为其配置至少一项「采集」参数。
- 边缘上报后，采集日志可按设备编码查到值。
- MQTT 监控可见对应客户端状态（环境启用 MQTT 时）；与日志客户端 ID 可对照。
- 导出日志/监控（有权限时）可用。
完整筛选与字段核对见维护与查询参考。
限制与待确认¶
以下边界容易被当成已验证事实，实际仍待环境或联调核实：
- 采集日志是否时序库、保留多久、可否人工改历史：网关仓外，待证实；培训默认以查询/导出为主。
- MQTT 状态是网关写入还是人工维护：页面偏监控，待联调确认。
- 与 MES 点检读参、WMS 部分作业读参的失败码与重试：见消费模块与
GAP-072。