43 对接配置操作手册

版本: v1.1 修改日期: 2026-05-29

本手册介绍 viSCADA 数据对接服务的配置下发、运行监控与参数说明。按本手册操作完成后,读者可以完成配置下发、运行状态与日志监控,并理解数据对接主配置与上报配置中各参数的含义与取值。

ℹ️ 文档中的”数据对接容器”指承载 Telegraf 采集任务的运行实例,是配置下发的最终生效载体。

1 整体操作流程

点击下发后,系统将最新配置推送至数据对接容器:

配置下发入口 图 2 配置下发入口

配置下发确认 图 3 配置下发确认

⚠️ 配置下发不是原子操作,建议在业务低峰期执行,并在下发后通过 3.1 对接服务监控确认新容器已正常接管。

在对接服务监控页面查看数据对接容器的运行状态与运行时长,确认配置是否已生效。

对接服务监控 图 4 对接服务监控

日志页面支持以下三项操作:

日志放大与还原 图 5 日志放大与还原

日志检索 图 6 日志检索

刷新最新日志 图 7 刷新最新日志

💡 日志单次最多显示 1000 行,排查长时间问题时建议结合关键字检索使用。若日志显示连接超时或网络异常,参见网络连通性测试手册进行分层排查。

用于检索当前生效的配置内容,以及脚本渲染后的最终配置,便于确认下发结果。

配置内容查看 图 8 配置内容查看

参数	当前值	说明
数据收集间隔(s)	`5`	Telegraf 采集周期，对应 `interval = "5s"`
补工况时间(h)	`24`	标准化链路单点位补数时间窗口
通用补工况时间(h)	`24`	viSCADA 原始数据补数时间窗口
自定义全局脚本	开启	启用自定义脚本处理逻辑
离线设备指令下发	开启	设备离线时是否允许下发指令
设备离线告警推送	开启	设备离线时是否推送告警
数据存储版本	`v2`	数据落库结构版本
原始数据保存策略	`1` 月	原始数据保留时长
Telegraf 版本	`1.33.0`	Telegraf 采集引擎版本
分时控制启用开关	关闭	是否启用分时段控制
收集时间取整	否	是否将采集时间对齐整点，对应 `round_interval = false`

以下参数用于性能调优，非必要场景保持默认即可。

参数	当前值	说明
单次批量输出指标数	`1000`	每次写出时发送的最大指标数，对应 `metric_batch_size`
指标缓冲区大小	`10000`	输出不可用时本地缓存的最大指标数，对应 `metric_buffer_limit`
采集随机抖动时间	`5s`	每次采集前增加随机延迟，对应 `collection_jitter`，避免多个实例同时采集造成瞬时压力
默认刷新间隔	`10s`	采集结果写出到输出插件的时间间隔，对应 `flush_interval`
刷新随机抖动时间	`0s`	每次写出前增加随机延迟，对应 `flush_jitter`，用于避免多个实例同时刷新
精度	默认	指标时间戳精度，对应 `precision = ""`
主机名	`telegraf`	配置的主机名，对应 `hostname = "telegraf"`
移除主机名标签	是	已启用 `omit_hostname = true`，指标中不会包含 `host` 标签，因此该主机名不会随指标上报