面向用户: viSCADA 实施 / 数据对接工程师 版本: v1.0
本手册介绍 viSCADA 数据对接服务的配置下发、运行监控与参数说明。按本手册操作完成后,读者可以完成配置下发、运行状态与日志监控,并理解数据对接主配置与上报配置中各参数的含义与取值。
ℹ️ 文档中的”数据对接容器”指承载 Telegraf 采集任务的运行实例,是配置下发的最终生效载体。
1 整体操作流程
图 1 数据对接配置四步流程
| 步骤 | 操作目标 | 对应章节 |
|---|---|---|
| 1. 配置下发 | 将最新配置下发至对接容器 | 2 配置下发 |
| 2. 运行监控 | 查看对接服务运行状态与时长 | 3.1 对接服务监控 |
| 3. 日志核查 | 检索运行日志定位异常 | 3.2 日志监控 |
| 4. 参数调优 | 调整数据对接与上报参数 | 4 数据对接配置、5 数据上报配置 |
2 配置下发
点击下发后,系统将最新配置推送至数据对接容器:
- 下发成功: 容器正常启动后配置生效
- 下发失败: 若配置文件异常,新容器启动异常,但原有数据对接容器不会停止,数据对接不中断
图 2 配置下发入口
图 3 配置下发确认
⚠️ 配置下发不是原子操作,建议在业务低峰期执行,并在下发后通过 3.1 对接服务监控 确认新容器已正常接管。
3 运行监控
3.1 对接服务监控
在对接服务监控页面查看数据对接容器的运行状态与运行时长,确认配置是否已生效。
图 4 对接服务监控
3.2 日志监控
日志页面支持以下三项操作:
| 操作 | 用途 | 图示 |
|---|---|---|
| 放大与还原 | 切换日志面板大小,便于查看完整日志 | 图 5 |
| 检索内容 | 按关键字筛选日志行 | 图 6 |
| 刷新最新日志 | 拉取最新日志内容,单次最多 1000 行 | 图 7 |
图 5 日志放大与还原
图 6 日志检索
图 7 刷新最新日志
💡 日志单次最多显示
1000行,排查长时间问题时建议结合关键字检索使用。若日志显示连接超时或网络异常,参见 viSCADA 网络连通性测试手册 进行分层排查。
3.3 配置内容查看
用于检索当前生效的配置内容,以及脚本渲染后的最终配置,便于确认下发结果。
图 8 配置内容查看
4 数据对接配置
4.1 常用参数
| 参数 | 当前值 | 说明 |
|---|---|---|
| 数据收集间隔(s) | 60 | Telegraf 采集周期 |
| 补工况时间(h) | 24 | 单点位补数时间窗口 |
| 通用补工况时间(h) | 24 | 全局补数时间窗口 |
| 自定义全局脚本 | 开启 | 启用自定义脚本处理逻辑 |
| 离线设备指令下发 | 开启 | 设备离线时是否允许下发指令 |
| 设备离线告警推送 | 开启 | 设备离线时是否推送告警 |
| 数据存储版本 | v2 | 数据落库结构版本 |
| 原始数据保存策略 | 1 月 | 原始数据保留时长 |
| Telegraf 版本 | 1.33.0 | 采集引擎版本 |
| 分时控制启用开关 | 关闭 | 是否启用分时段控制 |
| 收集时间取整 | 否 | 是否将采集时间对齐整点 |
4.2 高级参数
以下参数用于性能调优,非必要场景保持默认即可。
| 参数 | 当前值 | 说明 |
|---|---|---|
| 标准输出指标量 | 0 | 单次输出指标数量上限,0 表示不限制 |
| 输出指标缓冲区 | 0 | 输出缓冲区大小,0 表示使用默认值 |
| 插件随机睡眠时间 | 未设置 | 启动时插件随机延迟,避免同时启动造成瞬时压力 |
| 输出默认刷新间隔 | 未设置 | 输出插件默认刷新间隔 |
| 输出刷新随机时间 | 未设置 | 输出刷新时的随机抖动,避免同步刷新 |
| 精度 | 未设置 | 指标时间戳精度 |
| 主机名 | 未设置 | 上报主机名,留空使用系统主机名 |
| 移除主机名标签 | 是 | 是否从指标中移除 host 标签 |
图 9 数据对接基础参数
图 10 数据对接高级参数 — 上半
图 11 数据对接高级参数 — 下半
⚠️ 修改
Telegraf 版本、数据存储版本、原始数据保存策略等核心参数前,需与平台运维确认兼容性;变更后必须通过 2 配置下发 下发才会生效。
5 数据上报配置
数据上报配置用于控制对接数据向上游平台的推送行为。
图 12 数据上报配置
ℹ️ 本章具体字段说明待补充,请结合现场实际页面参数对照填写;变更后需通过 2 配置下发 使配置生效。
6 校验要求
配置变更后,按以下清单核查:
- **「配置下发」**操作无报错提示
- 在 3.1 对接服务监控 中确认新容器状态为运行中,且运行时长从
0开始累积 - 在 3.2 日志监控 中未检索到
error/E!等报错关键字 - 在 3.3 配置内容查看 中确认脚本渲染后的配置符合预期
- 关键业务数据在上游平台正常接收