8.9 KiB
8.9 KiB
一、培训整体框架
- 培训目的：面向实施/运维人员，讲解在物联网AIoT平台完成设备/网关/平台三种接入模式的配置与落地，包含账号与权限、网络组件、产品与物模型、设备创建与绑定、Topic订阅、数据入库与告警规则等完整流程。
- 方法论：
- 优先原则：鼓励“设备/平台主动推送到本平台”（稳定、低耦合）；“平台主动采集/消费对方MQTT/HTTP”作为兜底方案，尽量少用以减少平台负载与复杂度。
- N+1思路：网关场景下，先建“网关产品与网关设备”，再为下挂的N台子设备分别建“设备产品与设备设备”。
二、接入模式与术语
- 接入模式（南向）：
- 设备直连：设备自身具备网络能力（常见MQTT、HTTP），直接上报至平台。
- 平台直连：第三方平台承接设备数据后，推送至本平台（HTTP/MQTT）或本平台主动去消费其MQTT/HTTP。
- 网关接入：低功耗、无网设备通过网关汇聚后，网关推送或第三方平台转发到本平台；网关承担多设备数据的代理。
- 北向分发：本平台将数据提供给上级或其它业务系统（省厅、市级平台等），作为北向系统输出。
- 设备编码（deviceId）：数据路由的唯一关键；平台中需全局唯一，与上报数据字段一致；入库及路由依赖此字段，不能缺失或混用。
- 物模型：定义产品数据结构（标准字段+业务字段）；产品发布时自动在时序库创建超级表（字段按物模型生成）。
- Topic（MQTT）：消息主题的层级规范；实施过程中常出现“实际Topic有中间层级/示例不完整”的情况，需客户端校验并使用“+”通配符。
三、账号与权限（运营起步）
- 管理策略：
- 按项目、单位或技术服务商创建独立账号，实现数据隔离与便于运营管理（如番禺救援项目单独账号，城中村、水务局分别账号）。
- 管理员具备全局视图；生产环境严格管理账号与设备归属，避免混用。
- 使用场景：
- 技术服务商自助入驻：提供平台账号与使用指引，由对方自行创建设备、配置网关与订阅。
- 项目维度管理：平台管理员创建项目账号并分配权限，项目侧仅可查看与管理自身设备与数据。
四、网络组件配置（培训明确步骤）
- 目标：配置与第三方平台/设备的网络连接（MQTT/HTTP）以便采集或接收数据。
- 必备技术资料：
- 服务地址与端口、认证方式（账号/密码/密钥/签名）、Topic规范、数据结构示例（含设备编码）、是否需要脚本/加密。
- 操作要点：
- MQTT常用：mqt协议为物联网常见；也支持HTTP（对方平台较老或仅支持HTTP上报时使用）。
- 对于“平台主动消费对方MQTT”的场景，需要在网络组件中保存对方服务与认证信息，并在网关设备中配置订阅Topic。
- ClientId、连接URL可按文档要求设置；数据转换通常不需额外配置，除非对方格式特殊。
五、产品与物模型（网关/设备双模型）
- 产品类型：
- 网关产品：用于承载“平台主动采集/消费”或“网关直推”的数据入口。
- 设备产品（物联设备）：真实现场设备的产品定义，用于建立设备实例与业务字段承载。
- 发布动作：
- 产品发布会“动态建库”，在时序库创建超级表（字段来自物模型）；发布成功后方可创建设备并正常入库。
- 物模型设计细节：
- 网关物模型：通常比设备物模型复杂，需包含设备ID（如“sip”或设备编码字段）与外层结构，用于路由解析；同时包含type（类型/事件枚举）、告警信息、时间戳等。
- 设备物模型：可不重复配置设备ID（网关路由已确定归属），保留业务核心字段即可（如告警类型、子类、事件时间等）。
- 类型字段建议使用枚举；时间戳字段需勾选时序时间属性（long）。
- 字段命名与对方对齐，避免与平台保留关键字冲突。
六、设备创建与绑定（网关模式详解）
- 网关设备（基于网关产品）：
- 接入方式：选择“平台记录”（平台主动消费）或“网关直推”；在培训2实例中为“网关记录”（表示设备数据通过网关代理上报）。
- 协议备注：标注MQTT（便于识别）；数据方向对网关产品通常为“采集”。
- 订阅Topic：配置对方提供的Topic；如文档与现场不一致，使用“+”通配符适配中间层级；实施前用MQTT客户端验证。
- 子设备（N台设备）：
- 创建设备实例（基于设备产品），选择接入方式为“网关记录”（表示数据经网关代理到此设备）。
- 填写设备编码（与上报字段一致、平台唯一）；选择所属网关；保持必要业务信息（行业、位置等）。
- 数据方向：子设备为“上报”（通过网关代理上报）。
- 简化原则（培训2强调）：
- 设备侧无需重复配置设备ID（路由已确定）；避免冗余存储无用字段。
- 枚举值保持一致性；时间字段规范化。
七、真实案例与操作脉络（安全帽案例）
- 技术方案：安全帽设备→推到其自有MQTT服务→本平台作为消费者订阅其MQTT（平台主动采集）。
- 实施步骤：
- 获取技术文档与账号（MQTT地址、认证、Topic规范、数据示例）。
- 管理员创建项目或服务商账号，分配权限。
- 在平台网络组件中配置对方MQTT连接。
- 建立网关产品，发布（建表）。
- 建立网关设备，绑定网络组件，配置订阅Topic（必要时使用“+”通配符）。
- 建立设备产品（与网关物模型一致或适当简化），发布。
- 为每个安全帽创建设备实例（选择“网关记录”），填写设备编码，与网关关联。
- 启用网关与设备，开始接收并入库。
- 实施建议：
- 此“平台主动采集”方案为兜底，不建议作为默认；优先引导“设备/平台主动推送到本平台”。
八、规则配置与工作量（培训1说明）
- 告警规则并非统一套用到所有设备：
- 同一产品在不同部署场景要求不一，规则需按设备维度配置。
- 批量设备多时，需逐台配置（可考虑后续优化工具/模板导入）。
- 实操建议：
- 先“学会怎么用”，工作量问题后续再评估；规则配置入口位于设备维度。
九、常见问题与排障清单
- 未收到数据：
- 检查网络组件连通与认证（地址、端口、账号/密钥/签名）。
- 检查订阅Topic是否正确；使用MQTT客户端现场验证真实Topic与数据样例。
- 路由不正确：
- 网关物模型中设备ID解析是否正确；
- 子设备是否绑定对应网关；
- 通配符“+”是否覆盖中间层级。
- 入库异常：
- 物模型字段名/类型是否与实际数据对齐；
- 时间字段是否设为时序时间；
- 设备编码与上报是否一致，平台唯一索引是否冲突。
- 性能与稳定性：
- 尽量使用设备/平台主动推送；平台主动采集会增加任务负载；
- 大量设备接入需评估服务器资源（示例提到当前仅32G内存），必要时扩容。
十、实施与管理建议
- 接入前置清单：必须先拿到技术文档、真实数据样例、Topic清单与认证信息；先用客户端验证再在平台配置。
- 账号治理：生产环境严控账号与设备归属；按项目或服务商进行隔离。
- 模型与字段规范：保持与对方对齐命名与枚举；避免保留字；时间统一为long。
- 批量导入：产品发布后，再批量导入设备，减少手工工作量。
- 通配符使用：在订阅中用“+”处理中间层级差异，降低实施摩擦。
十一、培训中的关键原话要点（摘录式复原）
- “两种模式：别人平台推、我们去消费别人数据（安全帽案例为我们消费对方MQTT）。”
- “网关模式是N+1：网关产品+设备产品；网关设备承载多台子设备。”
- “设备编码是数据路由核心，平台唯一，数据包必须携带，不支持一个数据包混入多设备。”
- “设备产品侧可不再配置设备ID（已由网关路由确定），避免冗余。”
- “平台主动采集是备选兜底方案，为减少平台负载不建议默认采用。”
- “同产品不同现场规则不一，规则需按设备维度配置。”
十二、可输出的交付物（如需请告知）
- 设备/网关接入操作手册（带步骤截图与示例字段表）
- 接入资料清单模板（对方需提供的地址、认证、Topic、示例数据）
- 网关订阅与通配符指南（含常见Topic偏差案例）
- 物模型设计规范与示例（网关与设备双模型、枚举/时间字段设置）
- 排障速查表（采集-解析-路由-入库）