guide · platform
如何处理离线设备
设计检测、队列、运维预期与间歇性设备群的恢复策略。
版本、来源核对与技术审阅
- 适用场景
- 设备影子:期望状态、报告状态与不确定性
- 发布日期
- 版本
- 版本信息见一手来源
- 事实与来源
- 已于 2026年7月14日 对照所引来源核对
- 技术审查
- 暂无独立技术审阅记录
结论先行
一句话决策建议
离线是设备的正常状态;系统需要有限队列、真实状态展示以及安全的恢复语义。
直接回答
将离线视为设备的预期状态,而非需要隐藏的异常。定义如何检测缺失、置信度如何衰减、哪些数据或命令可以排队、排队工作何时过期,以及恢复如何调控。向运维人员展示断开连接、延迟、不可达、关机和未知之间的区别。安全的系统会限制积压量,并在重连后对当前状态进行核对,而非盲目重放所有内容。
范围与非范围
本指南涵盖设备、网关、代理和平台服务之间的连接丢失问题。它不诊断每种情况下的底层无线、电源、固件或账户问题。“离线”是特定层做出的观测,并非物理资产已停止运行的证明。
精确定义离线
在后果重要的场景中,不要仅依赖单一信号。MQTT keepalive 和会话断开指示传输层状态,但不洁净的网络路径可能需要时间才能检测到。应用心跳表明固件正在调度工作。遥测数据新鲜度反映特定测量流是否为最新。网关清单可以区分现场设备故障和网关上行链路丢失。
根据预期上报频率和网络波动选择阈值。每小时上报一次的设备不应在两分钟后就被判定为离线。表示诸如在线、延迟、离线、计划休眠、维护中、已退役和未知等状态。包含观测时间戳和来源,以便用户判断置信度。
按消息类型制定队列策略
不要对所有消息使用同一套离线队列。可替换的遥测数据在存储满时可采样、聚合或丢弃。持久事件可能需要本地持久化并附带序列号。期望状态通常可以折叠为最新版本。命令需要明确的过期时间、幂等性、前置条件和确认;过期的命令不应仅仅因为连接恢复就执行。
按字节、数量和时长限制队列。定义优先丢弃什么,并暴露丢失情况。在代理上,将持久会话过期和消息过期与产品预期对齐。在设备或网关上,保护闪存寿命并为关键事件预留容量。
恢复序列
- 使用随机化指数退避重连,在支持的情况下使用服务端引导的上限。
- 认证并仅恢复仍然有用的会话状态。
- 在处理旧工作之前,上报启动信息、固件版本、时钟和当前状态。
- 核对期望状态和已上报版本。
- 以受控速率排空持久事件,保留原始时间戳和标识符。
- 拒绝过期命令并确认其终态。
- 逐步恢复正常遥测,使恢复流量不会挤占控制或认证资源。
- 仅在所需数据流和业务结果恢复后才标记设备健康,而非在套接字连接时即标记。
运维体验
展示最后一次成功联系、预期频率、受影响的网关或区域、排队工作以及当前恢复阶段。避免使用二元红色图标,以免在共享故障期间生成数千个相同的工单。将相关故障分组,并识别可能的公共依赖。所有权和升级路径应取决于影响:一个离线的演示传感器和一个不可达的安全监测器不是同一级别的事件。
故障模式
固定重连间隔会使整个设备群与代理同步。无限制的代理队列会将一次中断转化为存储事件。重放旧命令可能覆盖更近期的本地决策。将新连接视为“健康”会隐藏订阅失败或下游处理故障。设备时钟在长时间中断后可能跳变,使事件顺序不可靠——除非保留序列号和接收时间。网关可能成功缓冲数据,而平台却错误地将每个子设备标记为离线。
实施清单
- 离线状态、信号、阈值和置信度已文档化。
- 休眠、维护、退役和未知设备有明确区分。
- 队列限制和丢弃顺序按消息类别定义。
- 命令具备 ID、前置条件、过期时间和结果确认。
- 重连使用抖动并遵循准入控制。
- 恢复时先发送当前状态,后处理过期积压。
- 运维人员可以查看共因范围和恢复进度。
- 测试覆盖代理、网络、网关、设备、时钟和存储故障。
需保留的证据
保留以下场景的追踪记录:正常断开、静默网络丢失、代理重启、网关中断、长时间休眠、队列溢出和过期命令恢复。记录实际检测延迟、积压时长、重连分布以及应用健康恢复时间。当上报频率、会话策略或代理限制发生变化时,重新运行这些场景。如果无法展示哪个信号产生了当前状态,仪表盘截图不足以作为证据。
服务级别决策
用用户语言陈述产品承诺:多快检测到缺失、哪些功能在本地继续、哪些数据得以保留、何时通知运维人员。将内部阈值与该承诺挂钩,而非照搬 keepalive 默认值。关键设备可能需要独立通道或本地告警;云端检测无法弥补断开的安全通道。
同时审视存储和恢复。更长的离线保留期会增加闪存使用、代理磁盘、排空时间以及旧上下文误导消费者的窗口。按设备类别记录所选权衡。更改队列或会话限制时,测试最旧支持的固件和最新固件。旧版客户端通常具有不同的重试、时间戳和确认行为,即使占设备群少数也可能在事件中占主导。
主要参考来源
OASIS MQTT 5.0 规范定义了 keepalive、会话、遗嘱消息、消息过期和会话过期。对于受限设备生命周期和状态预期,使用NISTIR 8259A。代理和客户端的持久化行为必须根据其官方文档进行验证并进行故障测试。
上线前必读
实施检查清单
- 根据可用证据对离线原因进行分类。
- 按业务相关性设置命令过期策略。
- 使用抖动重连和渐进式退避。
一手来源
事实核验
- OASIS MQTT Version 5.0访问日期 2026年7月14日
来源核对日期 2026年7月14日 · 下次计划核对: 2027年7月14日
维护记录
更新历史
- 2026年7月14日
- 首次发布
- 2026年7月14日
- 更新内容并核对来源
如有不清晰、不准确或过时的内容,请告诉我们。