使用 Zabbix 监控 DEVLINE 视频采集卡画面可用性:Windows CCTV 图像监控模板实战指南

原创2026-10-15 15:48:241,413 阅读

使用 Zabbix 监控 DEVLINE 视频采集卡画面可用性:Windows CCTV 图像监控模板实战指南

本文围绕 Zabbix Community Templates 仓库中的 DEVLINE Windows 监控模板展开,讲解如何借助 Zabbix agent 的自定义 UserParameter 与低级别发现(LLD)机制,逐路检测 DEVLINE 视频采集卡(CCTV 摄像头)画面是否正常输出,并在画面丢失或采集内核服务异常时自动告警。读完本文,你将掌握该模板的完整配置链路、监控项与触发器设计原理,并能在自己的 Zabbix 环境中快速部署一套 Windows 平台上的视频图像可用性监控方案。

模板概览:它监控什么、解决什么问题

DEVLINE 是一类运行于 Windows 平台的视频采集与监控软件,通过视频采集卡(capture card)接入多路 CCTV 摄像头。在实际运维中,最常见的故障并非摄像头物理损坏,而是采集卡掉线、通道无信号、画面静帧等"有设备但无画面"的隐性故障——这类问题无法通过主机层面的 CPU、内存指标发现,必须逐路探测画面信号本身。

本仓库中的 DEVLINE 模板(作者 ssharypov)正是为解决该问题而设计,其核心思路是:

  1. 通过两个自定义 UserParameter 调用外部可执行程序,直接与 DEVLINE 视频服务器交互;
  2. 用 devline.discovery 自动发现所有摄像头通道;
  3. 用 devline.viewpic[*] 对每个通道逐一检查画面是否正常;
  4. 任一通道连续多次无画面即触发 average 级告警,采集内核服务(SDevKernel)停止则触发 disaster 级告警。

模板目录下同时提供了面向 Zabbix 5.0、5.4、6.0 三种版本的导出文件,方便不同版本用户直接导入使用。

仓库文件构成与版本对应

本模板在仓库中的位置为 Applications/Security/template_devline_windows_monitoring_cctv,包含三个版本分支:

版本 导出格式 文件路径
Zabbix 5.0 XML template_devline._windows_mon_images_from_cameras.xml
Zabbix 5.4 YAML template_devline._windows_mon_images_from_cameras.yaml
Zabbix 6.0 YAML template_devline._windows_mon_images_from_cameras.yaml

各版本模板内容一致,仅导出格式与函数语法随 Zabbix 版本演进略有差异(例如 6.0 的 YAML 使用 last(/DEVLINE/devline.viewpic<a href="https://link.gitcode.com/i/ca2eb734b4c6946c7896570e51a5a79c" target="_blank">{#IMAGE_URI}],#3) 的新函数语法,5.0 的 XML 中则为 {last(#3)} 的相对函数写法)。每个版本目录下均有一份与 [6.0/README.md 内容相同的说明文档。

工作原理:两条 UserParameter 驱动的数据采集链路

模板的数据采集完全依赖 Zabbix agent 配置文件(zabbix_agentd.conf)中的自定义键。README 中给出了完整的 UserParameter 定义:

UserParameter=devline.discovery,"C:\Windows\zabbix\addons\devline-discovery.exe" user password 127.0.0.1

UserParameter=devline.viewpic[*],"C:\Windows\zabbix\addons\devline-check-picture.exe" user password 127.0.0.1 $1

其中 $1 = image-uri,即 devline.viewpic[*] 的第一个位置参数是摄像头的 image-uri(图像地址)。

整个监控链路可概括为:

Zabbix Server ──(轮询)──> Zabbix Agent(Windows)
                              │
                              ├─ devline.discovery ──> devline-discovery.exe ──> 返回摄像头列表(JSON) ──> LLD 生成 {#NAME}/{#IMAGE_URI}
                              │
                              └─ devline.viewpic[uri] ──> devline-check-picture.exe ──> 返回画面状态(1=正常/其它=异常) ──> 触发器判定

两条 UserParameter 的语义分工如下:

键 含义 用途
devline.discovery 无参数发现命令 返回全部摄像头通道列表,供 CamList 低级别发现规则消费
devline.viewpic[*] 带参检查命令,$1 为 image-uri 检查指定通道画面是否存在,输出 1 表示画面正常

命令中的 user password 127.0.0.1 为 DEVLINE 视频服务器侧的认证信息与回环地址,实际部署时应替换为真实的 DEVLINE 登录账号、密码及服务器地址;两个外部程序需放置于 C:\Windows\zabbix\addons\ 目录下,并保证 agent 运行账户具备执行权限。

环境依赖与前置条件

README 明确指出一条硬性依赖:

Требуется .NetFramework 3.5 на хосте с сервером наблюдения. (监控服务器所在主机需要安装 .NET Framework 3.5。)

即运行 devline-discovery.exe 与 devline-check-picture.exe 这两款外部工具的视频监控服务器主机,必须先启用 .NET Framework 3.5(Windows 功能中可通过"启用或关闭 Windows 功能"勾选 .NET Framework 3.5 安装,需联网或指定安装源)。

除此之外,部署前还需确认:

  • 目标主机为 Windows,且已安装可用的 Zabbix agent(被动模式即可,模板监控项均为 Zabbix agent 类型);
  • 外部程序 devline-discovery.exe、devline-check-picture.exe 已就位于 C:\Windows\zabbix\addons\;
  • 主机能通过 127.0.0.1 访问 DEVLINE 视频服务器(默认回环地址,可按需修改为实际 IP);
  • 已具备 DEVLINE 的访问账号与密码。

安装与配置步骤

1. 导入模板

在 Zabbix Web 前端中,进入 Data collection → Templates,点击右上角 Import,按自身 Zabbix 版本选择对应的导出文件上传:

导入成功后,模板列表中会出现名为 DEVLINE 的模板,其所属模板组为 CUSTOM。

2. 配置 agent 自定义键

在被监控的 Windows 主机上编辑 zabbix_agentd.conf,追加 README 中给出的两行 UserParameter,将 user password 替换为实际凭证:

UserParameter=devline.discovery,"C:\Windows\zabbix\addons\devline-discovery.exe" your_user your_password 127.0.0.1
UserParameter=devline.viewpic[*],"C:\Windows\zabbix\addons\devline-check-picture.exe" your_user your_password 127.0.0.1 $1

重启 Zabbix agent 服务使配置生效,并可用 zabbix_get 或 agent 的 zabbix_sender 测试链路连通性。

3. 关联模板并验证

将 DEVLINE 模板链接到对应的 Windows 监控主机上,等待一个采集周期后检查:

  • DEVLINE KERNEL 监控项是否返回数值型状态(0 表示 Running);
  • 低级别发现规则 CamList 是否在 1d 更新周期内发现了全部摄像头通道;
  • 各通道 devline.viewpic[{#IMAGE_URI}] 监控项是否返回 1。

监控项解析:从 YAML 导出看模板内部结构

通过阅读 6.0 的 YAML 模板导出,可以完整还原模板的监控项设计。

常规监控项:DEVLINE KERNEL

items:
  -
    name: 'DEVLINE KERNEL'
    key: 'service.info[SDevKernel,state]'
    delay: 3m
    history: 7d
    valuemap:
      name: 'Windows service state'

该监控项使用 Zabbix 内置的 service.info[<service>,state] 键,读取 Windows 服务 SDevKernel(DEVLINE 采集内核服务)的运行状态码,每 3 分钟采集一次,历史保留 7 天,并通过值映射 Windows service state 将状态码转换为可读文本。它承担"采集服务本身是否存活"的兜底监控职责。

低级别发现规则:CamList

discovery_rules:
  -
    name: CamList
    key: devline.discovery
    delay: 1d
    filter:
      conditions:
        -
          macro: '{#NAME}'
          value: '.*'
          formulaid: B
        -
          macro: '{#IMAGE_URI}'
          value: '.*'
          formulaid: A
    lifetime: 1d

发现规则每 1 天执行一次,调用 devline.discovery 键获取摄像头清单,为每个摄像头产出两个发现宏:

  • {#NAME}:摄像头名称,用于监控项与触发器命名;
  • {#IMAGE_URI}:摄像头 image-uri,作为 devline.viewpic[*] 的位置参数。

过滤器对两个宏均以正则 .* 放行全部条目;lifetime: 1d 表示摄像头从清单中消失后,其产生的原型实例会在 1 天后自动清理,避免僵尸监控项残留。

LLD 原型监控项:devline.viewpic

item_prototypes:
  -
    name: '{#NAME}'
    key: 'devline.viewpic[{#IMAGE_URI}]'
    delay: 10m
    history: 7d
    trends: '0'
    value_type: TEXT
    tags:
      -
        tag: Application
        value: Cameras

每个被发现的摄像头都会实例化一个 devline.viewpic[{#IMAGE_URI}] 监控项,每 10 分钟检查一次该通道画面。值得注意的细节:

  • value_type: TEXT:监控项按文本类型存储。结合 README 中"采集卡失效时程序会返回文本而非数字"的修复说明可以推断,外部程序在异常时可能输出错误文本,模板据此以 TEXT 类型兼容处理,避免 unsupported 状态;
  • trends: '0':关闭趋势存储,因为图像可用性属于离散状态值而非连续指标,无需趋势压缩;
  • 标签 Application: Cameras 便于在 Zabbix 中按应用分组筛选(5.0 XML 中对应 applications 分组,名称为 Cameras)。

触发器体系:两级告警与依赖抑制

画面丢失告警(average)

对每个 LLD 实例,模板生成了"无画面"触发器(README 触发器表中的 no image from [{#NAME}] 与 (LLD) 变体):

expression: 'last(/DEVLINE/devline.viewpic[{#IMAGE_URI}],#3)<>1'
recovery_mode: RECOVERY_EXPRESSION
recovery_expression: 'last(/DEVLINE/devline.viewpic[{#IMAGE_URI}])=1'
priority: AVERAGE
manual_close: 'YES'

语义解读:

  • last(...,#3)<>1:取该监控项倒数第 3 次采样的值,若不为 1 即触发告警。由于采集间隔为 10 分钟,这相当于要求画面在过去约 20~30 分钟内持续异常才告警,起到简单的确认/去抖作用;
  • 值 1 表示画面正常,非 1 值(0、错误文本等)表示画面丢失——该约定由恢复表达式 ...=1 反向印证;
  • recovery_mode: RECOVERY_EXPRESSION:使用独立的恢复表达式,只要最近一次采样值恢复为 1 即自动恢复,无需人工确认(manual_close: YES 同时允许手动关闭)。

内核服务宕机告警(disaster)

在 README 的触发器表格之外,YAML 导出中还定义了一条模板级触发器:

triggers:
  -
    expression: 'last(/DEVLINE/service.info[SDevKernel,state])<>0'
    name: 'Devline Kernel Service is not Running'
    priority: DISASTER

当 SDevKernel 服务的状态码不为 0(Running)时触发 disaster 级告警。结合值映射可知,0 以外的取值涵盖 Paused、Start pending、Stopped 乃至服务不存在等全部非运行态,因此该触发器实际表达的是"采集内核服务不在运行"这一最严重故障。

依赖关系:避免告警风暴

dependencies:
  -
    name: 'Devline Kernel Service is not Running'
    expression: 'last(/DEVLINE/service.info[SDevKernel,state])<>0'

所有"无画面"触发器均声明依赖上述 disaster 触发器:当采集内核服务整体宕机时,所有通道必然同时无画面,此时只上报 disaster 级根因告警,average 级的逐通道告警被依赖机制抑制,避免几十路摄像头同时刷屏的告警风暴。这是该模板在告警设计上的一大亮点。

值映射:Windows 服务状态可读化

模板内置了名为 Windows service state 的值映射(YAML 文件),将 Windows 服务状态码翻译为直观文本:

数值 可读状态
0 Running
1 Paused
2 Start pending
3 Pause pending
4 Continue pending
5 Stop pending
6 Stopped
7 Unknown
255 No such service

DEVLINE KERNEL 监控项即应用此值映射,使运维人员在前端直接看到 "Running" 而非裸数字;disaster 触发器则基于原始数值 0 判定,二者互不干扰。

实战注意事项与故障排查

  1. 采集卡失效时的文本输出问题:README 的更新记录(UPD 2019-13-02)指出,当某路采集卡停止工作后,外部程序会输出文本而非数字,模板已针对此问题修正。若你在旧版本基础上自行实现,务必让 devline-check-picture.exe 的输出同时兼容数字与文本,并将监控项值类型设为 TEXT,否则会出现 unsupported 或无法触发告警。
  2. 触发器采样窗口:last(#3)<>1 意味着需要连续约 3 个采样周期(约 20~30 分钟)无画面才告警,若希望更快响应,可将触发器改为 last(/DEVLINE/devline.viewpic[{#IMAGE_URI}])<>1 或缩短监控项采集间隔。
  3. 依赖的误配置风险:disaster 触发器依赖表达式与无画面触发器所引用的监控项一致(均来自 DEVLINE 模板),若自行修改监控项键值,需同步更新依赖关系,否则依赖失效。
  4. 外部程序路径与权限:C:\Windows\zabbix\addons\ 属系统目录,需确认 Zabbix agent 运行账户有执行权限;路径或文件名一旦变动,UserParameter 与模板中的键需同步调整。
  5. 首次导入后的等待周期:发现规则更新周期为 1d,新摄像头接入后最长需等待一个发现周期才会生成监控项;lifetime: 1d 保证下线摄像头的实例会在 1 天后自动清理。
  6. 告警 URL 占位:模板中无画面触发器配置了 https://snowbars.ru 作为默认告警链接,这是作者留下的示例占位,生产环境建议替换为内部运维面板或工单系统地址。

结语

DEVLINE Windows 监控模板展示了 Zabbix 在视频监控运维领域的一种典型打法:用自定义 UserParameter 对接业务软件私有接口,用 LLD 把"逐路摄像头检查"变成自动化过程,再用"依赖 + 分级告警"把画面丢失与内核宕机两类故障收敛到清晰的告警体系。对于任何需要监控视频采集、图像输出类系统的 Zabbix 用户,这套"发现—探测—分级—依赖"的四步设计都具备直接的参考与复用价值。部署时请以仓库内 5.0 / 5.4 / 6.0 对应版本的导出文件为准,并按上文步骤替换凭证与路径即可投入使用。

登录后查看全文
community-templates