数据转发

数据转发用于在平台收到设备数据后，将数据自动推送到外部系统。

它适合实时同步、业务系统集成、外部数据库归档和告警分析等场景。

【配图占位：数据转发配置列表截图，突出类型、启用状态、优先级、发送统计】

什么时候使用数据转发

场景	建议
外部系统需要实时收到新数据	使用数据转发
第三方数据库需要持续保存设备数据	使用数据转发
只需要偶尔查询历史数据	使用 API 或数据导出
业务系统需要主动管理设备和点位	使用开放 API

数据转发是“平台主动推送”。开放 API 是“外部系统主动请求”。

支持的转发类型

类型	主要用途	文档
HTTP Post	推送到 Webhook、业务服务器、云函数	HTTP Post
MQTT	发布到 MQTT Broker，供 IoT 系统订阅	MQTT
MongoDB	写入外部 MongoDB，用于查询或 BI	MongoDB
InfluxDB	写入时序数据库，用于 Grafana 或监控	InfluxDB
S3 / OSS	归档到对象存储，用于离线计算或备份	S3 / OSS

部分类型可能需要平台开通或后续版本支持。以实际页面可选项为准。

转发配置

一条转发配置通常包含：

字段	说明
名称	用于区分不同转发配置
类型	HTTP、MQTT、MongoDB、InfluxDB、S3 等
启用状态	暂停后不再发送，但配置保留
优先级	多条配置同时存在时的执行顺序
目标配置	目标系统连接信息、认证信息和主题等

【配图占位：创建数据转发配置弹窗截图】

优先级

同一组织可以配置多条转发规则。优先级用于控制执行顺序。

优先级数值越高，通常越先执行。

如果外部系统之间没有依赖关系，优先级一般无需特别调整。

数据格式

不同转发类型的字段可能略有差异，但通常包含：

• 组织或项目标识
• 设备标识
• 点位标识
• 点位类型
• 数值
• 单位
• 时间戳

外部系统应以实际接收到的数据字段为准，并做好字段缺失或新增字段的兼容处理。

安全建议

• Webhook 地址应使用 HTTPS。
• 不要把数据库账号、Token 或密钥暴露在公开环境。
• 为转发用途创建专用账号或专用凭据。
• 定期轮换密钥。
• 外部系统应校验请求来源或签名。

常见问题

问题	检查项
外部系统没有收到数据	配置是否启用、目标地址是否可达、认证是否正确
只收到部分数据	设备是否上报、点位是否启用、外部系统是否过滤
MongoDB 中没有数据	URI、数据库权限、collection 配置是否正确
MQTT 订阅不到	Host、Port、Topic、用户名密码、网络连通性
HTTP 返回错误	外部接口是否接受 POST、请求体格式是否兼容

与数据导出的关系

数据转发面向实时推送，数据导出面向历史文件下载。

如果需要长期在自己的数据库中保存数据，建议使用数据转发。如果只是临时分析某段历史数据，建议使用数据导出。