数据转发

数据转发把 GatewayRuntime 已采集到的变量、设备状态、报警和事件发送到外部系统，也可以写入实时数据、历史数据或历史报警目标。

页面只需要理解两个对象：转发组决定“发送哪些数据、什么时候发送”，转发目标决定“发送到哪里”。

最短配置流程

1. 进入“开发配置 → 数据转发”，新建一个转发组。
2. 变量范围选择“手动选择”，触发模式选择“定时”，定时间隔填 1000，保存。
3. 重新编辑这个组，在下方“转发变量”中搜索一个已有变量，选中后点击旁边的加号，再点击“保存”。具体见维护组变量。
4. 在转发组下新增目标，选择目标插件，填写连接参数并保存。需要外部字段或地址时，再维护目标的“变量属性”。
5. 启用转发组和目标，确认目标运行正常。
6. 到接收端查看这个变量的数据；仅看到目标在线，还不能说明已经上传成功。

页面入口

菜单路径：开发配置 → 数据转发。

区域	用途
转发组列表	新增、编辑、删除、启停和重启转发组。
转发目标列表	管理所选转发组下的目标、变量属性和目标运行状态。
详情区	查看详细信息、组日志、目标日志和调试页。

配置转发组

点击转发组面板的新增按钮，打开转发组配置抽屉。

配置项	说明
名称	转发组显示名称，建议体现业务范围，例如“生产线A_实时上传”。
启用	控制该组是否运行。禁用后组下目标不会启动。
日志级别	组级日志详细程度。联调时可临时提高，稳定后恢复 Info。
变量范围	可选全部变量、手动选择、采集设备或采集组。
范围配置	使用采集设备或采集组范围时，填写对应名称；多个名称用英文逗号分隔。
触发模式	变化、定时、定时或变化。
定时间隔	触发模式包含定时时填写毫秒数或 Cron；常规周期优先填毫秒数，例如 1000。
在线过滤	开启后只发送在线变量。
分批模式	不分批、全部合并、按数据组、按设备或按采集组分批。
最大批量	一批最多包含的变量数量，用于控制消息或请求大小。
描述	记录组用途、范围和维护说明。

变量范围怎么选

范围	适用场景
全部变量	整站上传。
手动选择	只转发少量关键点位或试点变量。
采集设备	按设备名称筛选，适合同一设备或一组设备。
采集组	按变量的采集组筛选，适合按业务分组。

触发和分批怎么选

需求	建议
值改变就发送	选择“变化”。
固定周期上报	选择“定时”，填写毫秒数。
变化和周期都要发送	选择“定时或变化”。
每台设备一条消息	分批选择“按设备”。
每个业务组一条消息	分批选择“按数据组”或“按采集组”。
数据量小、目标自行处理批量	选择“不分批”。

维护组变量

手动选择范围下，组变量列表就是该组的成员名单；其它范围下，组变量主要用于覆盖变量级设置。

只上传指定的几个变量

1. 新建转发组，把“变量范围”设为“手动选择”，先点击“保存”。新组尚未保存时，不能添加变量。
2. 在转发组列表中编辑刚保存的组，向下找到“转发变量”。
3. 在“选择转发变量或覆盖配置”中输入变量名，选中正确的“设备名.变量名”。
4. 点击选择框旁的加号。确认变量出现在下面的表格中，且“启用”已打开。
5. 重复添加其他变量，点击弹窗底部“保存”。只选下拉选项而没点加号，不会加入该组。
6. 重新打开组检查成员。要停止上传其中一个变量，可关闭该行“启用”并保存；要移出该组，删除该行并保存。这不会删除原来的采集变量。

不需要自定义数据组、别名或单变量触发方式时，保持默认即可。

配置项	说明
变量	选择要加入或覆盖配置的变量。
启用	控制该变量是否参与当前组。
数据组	用于“按数据组”分批。
更新	覆盖该变量的触发方式。
组触发	开启后变量变化可以唤醒整个转发组。
别名	转发时使用的外部变量名称。

配置转发目标

先选中转发组，再点击目标面板的新增按钮。

配置项	说明
所属转发组	当前目标归属的转发组；目标只消费该组范围内的数据。
目标名称	同一转发组内唯一，用于日志、冗余和导入导出定位。
启用	控制目标是否运行。启用后才会进入运行态并支持调试。
插件	选择数据转发插件；选择后显示对应的插件属性。
日志级别	控制目标日志详细程度。
启动超时	目标连接或初始化的等待时间，单位秒。
描述	记录目标用途和维护说明。
插件目标属性	由具体插件提供，字段含义见对应插件手册索引。

插件参数在哪里看

公共页面只说明目标的创建和启停。MQTT、Kafka、RabbitMQ、Webhook、Modbus、OPC UA、IEC104、IEC61850、数据库和 SyncBridge 的专用参数、模板、调试页及排障方法，统一放在对应的数据转发插件手册。

目标变量属性

目标变量属性是“某个变量在某个目标下的外部映射”，不是转发组成员范围。

常见用途包括：

• 外部字段名、别名和自定义数据字段。
• Modbus 从站地址、数据类型和写入权限。
• MQTT、Kafka、RabbitMQ、Webhook 等目标的上传字段。

历史数据存储的采样范围和触发方式在转发组中配置，不在“目标变量属性”中重复设置。

配置前先选择有效的转发目标和变量。变量必须先进入转发组范围，目标变量属性才会生效。

1. 选中目标，打开“变量属性”。
2. 选择要配置的变量，填写当前插件要求的映射字段。
3. 点击“新增变量属性”；修改已有记录时点击“更新变量属性”。
4. 确认记录出现在列表中，再到接收端核对字段或地址。不要用这里代替上面的“转发变量”成员设置。

启停和验证

保存后依次确认：

1. 转发组已启用。
2. 目标已启用并显示运行状态。
3. 目标的变量范围不是空集。
4. 目标日志没有连接、认证或发送错误。
5. 外部系统能看到一条测试数据。

目标在线不等于数据已经送达；必须结合目标日志和外部系统接收结果判断。

调试和日志

选中目标后，点击详情区的“调试”。不同插件会显示不同的专用调试页，例如发布、订阅、客户端列表、服务端状态或协议操作。

目标无法启动或数据没有发出时，先看“转发目标日志”，再看“转发组日志”。

现象	先检查
目标没有启动	组和目标是否启用，插件是否启用，目标参数是否完整。
没有数据发出	变量范围、变量启用状态、触发模式和在线过滤。
目标显示在线但外部没有数据	目标日志、外部账号权限、Topic/URL/表名和数据格式。
定时转发不触发	触发模式是否包含定时，定时间隔是否为毫秒数或 Cron。
变化转发不触发	变量是否真实发生变化；需要唤醒整组时检查“组触发”。
离线缓存持续增长	外部系统是否恢复，磁盘空间、上传分片和并发数是否足够。

目标冗余

目标冗余用于主备目标切换。

1. 主目标和备用目标必须在同一转发组内。
2. 备用目标建议使用相同插件，并单独填写连接参数和认证信息。
3. 备用目标不能同时作为其它目标的备用目标，也不要开启自己的冗余。
4. 上线前手动切换一次，确认备用目标能够发送。

导入导出

1. 点击转发组面板的“导出配置”，保留一份原始文件作为备份。
2. 修改副本，保留导出的工作表名称、列名及组与目标之间的关联。换网关使用前，先在新网关准备好同名采集设备和变量。
3. 点击“导入配置”，选择修改后的文件。选择文件后即开始导入，不是只预览。
4. 查看导入结果中的各工作表和失败行。发生错误时，先检查当前配置，不能假定整份文件都没有写入。
5. 重新打开转发组，检查成员、目标插件和变量属性，再确认目标连接和接收结果。

相关链接

• 采集配置：配置通道、设备和变量。
• 插件手册索引：查看每个转发插件的专用属性和调试页。
• 系统日志：查看后台、操作和 RPC 日志。
• 系统设置：配置网络、证书、冗余和系统控制。