北向上报

北向把网关的数据与事件送到云端或上级平台。当前主通道为 MQTT；REST API 与 Prometheus 指标并行可用。

MQTT 上报

配置北向 broker（环境变量或界面设置）后，数据与告警按主题模板上报，模板支持变量替换（设备 ID、产品、告警级别等）。

• 连接：支持自签 CA（EDGE_MQTT_CA_FILE）与受控内网跳过校验（EDGE_MQTT_INSECURE，仅调试用）
• 重连：断线自动重连并重订阅；订阅失败视为启动失败——不会带着假连接跑
• 主题：按模板体系组织，云端订阅规则稳定可预期

断网缓存与按序补传

北向不可达时，数据落本地缓存：

• 双限护栏：条数上限 + 字节上限，满了丢最旧（内存与磁盘不会被打爆）
• 恢复后按序补传：FIFO 顺序不乱；时钟倒退防护保证补传序列的时间单调性
• 补传期间新数据照常产生与缓存，不需要人工干预

数据保留

• 时序数据保留期可配，到期清理
• bbolt 定期回收空间
• 告警与运行记录独立保留

对接云端平台

网关上报的是标准 MQTT JSON，云端可以是你的平台、RuleGo-Server，或任何 MQTT 消费者。需要按你的平台报文格式定制字段映射时，在规则链里用转换节点完成，或联系商务做岗位包级定制。