Zabbix「Windows by Zabbix agent active」模板实战指南:基于主动式 Agent 的 Windows 全栈监控

原创2026-10-09 17:22:151,950 阅读
文章标签:运维指标监控可观测性告警监控大盘APM日志分析后端前端消息队列高可用分布式数据库

Zabbix「Windows by Zabbix agent active」模板实战指南:基于主动式 Agent 的 Windows 全栈监控

导读

本文以 Zabbix 官方模板 Windows by Zabbix agent active(仓库路径 templates/os/windows_agent_active/README.md,模板定义 template_os_windows_agent_active.yaml)为骨架,完整讲解该模板的适用场景、部署前提、全部宏定义、监控项、触发器表达式与 7 大类自动发现规则,并结合仓库内 Zabbix agent 的 perf_counter_en、wmi.getall、vfs.fs.get、service.discovery 等底层实现,剖析主动式(active)监控模式下每类数据是如何采集、预处理并触发告警的。读完本文,你将能够:独立部署主动式 Windows 监控、按业务定制 60+ 个阈值宏、理解 CPU/内存/磁盘/网络/安全/合规六大维度的告警逻辑,并学会用上下文宏做分区、分接口、分服务的精细化告警治理。


1. 模板定位与使用前提

1.1 什么是「Windows by Zabbix agent active」

该模板是 Zabbix 官方出品的 Windows 操作系统监控模板,专门面向主动式(active)Zabbix agent。与被动式(passive)模式由 Zabbix server 定时拉取数据不同,主动模式下 agent 自行连接 server 并主动推送数据(见 conf/zabbix_agentd.conf 中 ServerActive、RefreshActiveChecks、BufferSend 等配置项,默认 ServerActive=127.0.0.1),因此:

  • 适合 agent 位于 NAT 之后、防火墙受限、无法被 server 主动连接 的 Windows 主机;
  • 数据采集由 agent 侧发起,server 仅需开放 trapper 端口接收。

模板在 YAML 头部声明了版本与归属(template_os_windows_agent_active.yaml):

  • zabbix_export: version: '8.0',即模板语法目标为 Zabbix 8.0;
  • 模板名 Windows by Zabbix agent active,归属组 Templates/Operating systems;
  • 官方说明:要求 Zabbix agent 8.0 或更新版本(wizard_ready: 'YES',由官方 "Templator" 工具生成)。

1.2 兼容性要求

项目 要求
Zabbix 版本 8.0 及以上
Agent 版本 8.0 及以上
已测试 Windows 客户端 Windows 7 及更新版本
已测试 Windows Server Windows Server 2008 R2 及更新版本

配置模板前,请按官方 "Templates out of the box" 章节说明完成 Zabbix 基础配置(部署 agent、建立 host、链接模板等)。本文仅介绍模板本身的使用与原理。


2. 部署与接入步骤

2.1 在 Windows 上安装 Zabbix agent

  1. 在目标 Windows 主机上安装 Zabbix agent 8.0+,安装时选择主动模式配置;
  2. 编辑 agent 配置(Windows 上通常为 zabbix_agentd.conf),至少设置:
    • ServerActive=<zabbix_server或proxy地址>[:port]:主动推送的服务器地址;
    • Hostname=<host名>:须与 Zabbix 前端中该主机的名称一致(未设置时可由 HostnameItem 获取,见 conf/zabbix_agentd.conf 中 Hostname / HostnameItem 选项说明);
  3. 启动并验证 agent 已建立主动连接(可用模板内置 zabbix[host,active_agent,available] 项观察)。

2.2 在 Zabbix 前端接入模板

  1. 数据采集 → 模板 → 搜索 "Windows by Zabbix agent active",导入(模板已随官方发布打包,YAML 源文件即 template_os_windows_agent_active.yaml);
  2. 为 Windows 主机链接模板;
  3. 按需在主机级或模板级覆盖宏(见下文宏清单);
  4. 等待第一个采集周期后即可在「最新数据」中查看监控项。

2.3 主动模式的可用性判定

模板用两个指标判定 agent 是否存活:

  • zabbix[host,active_agent,available](Zabbix internal 类型):值 0=unknown、1=available、2=not available,对应主机列表中的可用性图标;
  • agent.ping:agent 恒返回 1,配合 nodata() 做无数据告警。

对应两条告警(见 YAML 中 L1700-L1725 附近):

  • Windows: Active checks are not available(High):min(/Windows by Zabbix agent active/zabbix[host,active_agent,available],{$AGENT.TIMEOUT})=2,即 {$AGENT.TIMEOUT}(默认 5m)内主动检查持续不可用;
  • Windows: Zabbix agent is not available(Average,需手动关闭):nodata(/Windows by Zabbix agent active/agent.ping,{$AGENT.NODATA_TIMEOUT})=1,即 {$AGENT.NODATA_TIMEOUT}(默认 30m)内未收到 agent 心跳。

3. 宏(Macros)全清单与调优指南

模板内置 40+ 个用户宏,全部声明于 YAML 的 macros: 段(L2824 起)。宏按用途分为可用性/性能阈值、自动发现过滤器、安全合规三大类,均可按需在主机或模板级别覆盖;部分宏支持 上下文(context),可针对特定磁盘、接口、服务单独设值。

3.1 可用性相关宏

宏 默认值 含义与调优建议
{$AGENT.NODATA_TIMEOUT} 30m 主动 agent 的无数据超时。文档明确建议保持相对较高的值,避免网络抖动或 agent 重启造成误报
{$AGENT.TIMEOUT} 5m agent 被判定不可用的超时(用于 active_agent available 告警)

3.2 CPU 相关宏

宏 默认值 含义
{$CPU.UTIL.CRIT} 90 CPU 利用率(%)临界阈值
{$CPU.INTERRUPT.CRIT.MAX} 50 % Interrupt Time 临界阈值(文档提示该值长期高于 20% 即可能预示硬件问题)
{$CPU.PRIV.CRIT.MAX} 30 % Privileged Time 阈值
{$CPU.QUEUE.CRIT.MAX} 3 Processor Queue Length 阈值(实测经验:PQL 不应超过核数 × 2)

3.3 内存与交换分区宏

宏 默认值 含义
{$MEMORY.UTIL.MAX} 90 内存利用率告警阈值(%)
{$SWAP.PFREE.MIN.WARN} 20 最小可用交换空间(%)告警阈值
{$MEM.PAGE_TABLE_CRIT.MIN} 5000 Free System Page Table Entries 告警阈值(低于 5000 可能内存泄漏)
{$MEM.PAGE_SEC.CRIT.MAX} 1000 Memory Pages/sec 告警阈值(高于 1000 可能过度分页导致内存泄漏)

3.4 文件系统相关宏

宏 默认值 含义
{$FSCONTROL} 1 文件系统空间告警总开关,可带文件系统名作为上下文(如 {$FSCONTROL:"C:"}=0 屏蔽该卷告警)
{$VFS.FS.PUSED.MAX.WARN} 80 文件系统利用率告警阈值(%)
{$VFS.FS.PUSED.MAX.CRIT} 90 文件系统利用率严重阈值(%)
{$VFS.FS.FSNAME.MATCHES} / .NOT_MATCHES .* / ^\s$ 按文件系统名过滤发现
{$VFS.FS.FSTYPE.MATCHES} / .NOT_MATCHES .* / ^\s$ 按文件系统类型过滤发现
{$VFS.FS.FSDRIVETYPE.MATCHES} / .NOT_MATCHES fixed / ^\s$ 按驱动器类型过滤发现,默认仅发现固定磁盘(排除光盘、移动盘)

3.5 物理磁盘(PDH)宏

宏 默认值 含义
{$VFS.DEV.UTIL.MAX.WARN} 95 磁盘时间利用率告警阈值(%)
{$VFS.DEV.READ.AWAIT.WARN} 0.02 读请求平均响应时间(秒)告警阈值
{$VFS.DEV.WRITE.AWAIT.WARN} 0.02 写请求平均响应时间(秒)告警阈值
{$VFS.DEV.DEVNAME.MATCHES} / .NOT_MATCHES .* / _Total 物理磁盘发现过滤(默认排除 _Total 汇总实例)

3.6 网络接口宏

宏 默认值 含义
{$IFCONTROL} 1 "link down" 告警总开关,可带接口名上下文(设 0 表示该接口不重要、下线不告警)
{$IF.UTIL.MAX} 90 接口带宽利用率告警阈值(%)
{$IF.ERRORS.WARN} 2 错误包速率告警阈值(pps),可带接口名上下文
{$NET.IF.IFNAME.MATCHES} / .NOT_MATCHES .* / 超长默认值(见模板) 接口名发现过滤
{$NET.IF.IFALIAS.MATCHES} / .NOT_MATCHES .* / CHANGE_IF_NEEDED 接口别名发现过滤
{$NET.IF.IFDESCR.MATCHES} / .NOT_MATCHES .* / CHANGE_IF_NEEDED 接口描述发现过滤

3.7 Windows 服务宏

宏 默认值 含义
{$SERVICE.NAME.MATCHES} / .NOT_MATCHES ^.*$ / 超长默认值(见模板) 按服务名过滤发现
{$SERVICE.STARTUPNAME.MATCHES} ^(?:automatic|automatic delayed)$ 只发现自动启动的服务
{$SERVICE.STARTUPNAME.NOT_MATCHES} ^(?:manual|disabled)$ 排除手动/禁用服务
{$SERVICE.STARTUPTRIGGER.MATCHES} / .NOT_MATCHES ^.*$ / ^1$ 按启动触发器过滤(^1$ 排除带触发器启动的服务)
{$SERVICE.FORBIDDEN.MATCHES} CHANGE_IF_NEEDED 列出必须保持停止的服务;命中者不论启动类型都会被发现并监控
{$SERVICE.STARTUP.GRACE} 10m 系统启动后的宽限期(默认 10 分钟),期间不检查服务状态,给 "automatic delayed" 服务留出启动时间;可带服务名上下文

3.8 Windows 计划任务宏

宏 默认值 含义
{$WINDOWS.TASK.NAME.MATCHES} CHANGE_IF_NEEDED 计划任务发现必须显式设置——文档特别说明:Windows 原生安装约有 200 个计划任务,未设置时不发现任何任务
{$WINDOWS.TASK.NAME.NOT_MATCHES} ^\s$ 任务名排除过滤
{$WINDOWS.TASK.PATH.MATCHES} / .NOT_MATCHES .* / ^\s$ 任务路径过滤
{$WINDOWS.TASK.CONTROL} 1 计划任务状态告警开关,可带任务名上下文

3.9 安全合规宏(激活 / Defender / 更新 / 防火墙 / BitLocker / SecureBoot)

宏 默认值 含义
{$WINDOWS.SECURITY.SECUREBOOT.IGNORE} 0 设为 1 可抑制 "SecureBoot is disabled" 告警(适用于合法运行于传统 BIOS/CSM 的主机)
{$WINDOWS.SECURITY.ACTIVATION.GRACE.MIN.WARN} 30d Windows 激活宽限期剩余时间告警阈值
{$WINDOWS.SECURITY.DEFENDER.SIGNATURE.MAX.WARN} 7d Defender 病毒库最大年龄告警阈值
{$WINDOWS.SECURITY.DEFENDER.FULLSCAN.MAX.WARN} 30d Defender 全盘扫描最大间隔告警阈值
{$WINDOWS.UPDATES.STALE.MAX.WARN} 45 距最近一次安装更新(KB)的天数告警阈值
{$WINDOWS.UPDATES.SECURITY.STALE.MAX.WARN} 60 距最近一次安全更新(KB)的天数告警阈值
{$WINDOWS.SECURITY.FW.PROFILE.MATCHES} ^(Domain|Private|Public)$ 防火墙配置文件发现过滤(按 profile 名)
{$WINDOWS.SECURITY.FW.PROFILE.NOT_MATCHES} CHANGE_IF_NEEDED 防火墙 profile 排除过滤
{$WINDOWS.SECURITY.BITLOCKER.FSNAME.MATCHES} ^[A-Za-z]: BitLocker 卷发现过滤(按盘符,如 "C:")
{$WINDOWS.SECURITY.BITLOCKER.FSNAME.NOT_MATCHES} CHANGE_IF_NEEDED BitLocker 卷排除过滤
{$WINDOWS.SECURITY.BITLOCKER.ENFORCE.MATCHES} ^C:$ 强制加密卷列表(按盘符):只有命中该宏的卷才会触发 "BitLocker is not enabled" 告警

说明:上表中部分宏的 NOT_MATCHES 默认值在 README 中被简写为 "Macro too long. Please see the template.",完整默认值请以 YAML 文件中的 macros: 段(templates/os/windows_agent_active/template_os_windows_agent_active.yaml#L2824)为准。


4. 监控项(Items)体系

模板监控项全部为 Zabbix agent (active) 或 Dependent(依赖项) 类型。依赖项的原始数据来自一个 "master item"(如 wmi.getall、vfs.fs.get),再经 JSON Path / JavaScript / 自定义倍数等预处理拆出具体指标。这种"一次采集、多项派生"的设计大幅降低了 agent 侧的采集开销。

4.1 基础系统信息(带预处理)

监控项 Key 说明
操作系统 system.sw.os 预处理:Discard unchanged with heartbeat 1d
OS 架构 system.sw.arch 同上
系统描述 system.uname 同上
系统名称 system.hostname 同上(配合 change() 触发"系统名已变更"告警)
Agent 主机名 agent.hostname 同上
Agent 版本 agent.version 同上
本地时间 system.localtime[local] —
运行时间 system.uptime 格式 "N days, hh:mm:ss",last()<10m 触发重启告警

这些项采用 Discard unchanged(值未变化则丢弃) 预处理,可显著减少主动模式下无意义数据的传输。

4.2 CPU 监控:Perfmon 计数器 + 汇总项

监控项 Key 说明
CPU utilization system.cpu.util 汇总 CPU 利用率(%),驱动 {$CPU.UTIL.CRIT} 告警
CPU DPC time perf_counter_en["\Processor Information(_total)\% DPC Time"] 延迟过程调用时间(DPC 属特权模式,高值可能预示处理器瓶颈)
CPU interrupt time perf_counter_en["\Processor Information(_total)\% Interrupt Time"] 硬件中断耗时,>20% 提示硬件问题
CPU privileged time perf_counter_en["\Processor Information(_total)\% Privileged Time"] 内核模式执行时间
CPU user time perf_counter_en["\Processor Information(_total)\% User Time"] 用户模式执行时间
CPU queue length perf_counter_en["\System\Processor Queue Length"] 就绪队列中等待执行的线程数
Number of cores wmi.get[root/cimv2,"Select NumberOfLogicalProcessors from Win32_ComputerSystem"] 逻辑处理器数量;预处理正则 (\d+) \1 提取数值,失败则丢弃
Context switches/sec perf_counter_en["\System\Context Switches/sec"] 全处理器上下文切换速率
Number of threads perf_counter_en["\System\Threads"] 全部运行进程使用的线程数
Number of processes proc.num[] 进程总数

底层原理:perf_counter_en 是 Windows agent 的 PDH 性能计数器读取接口,定义于 src/libs/zbxsysinfo/win32/pdhmon.c。其实现先校验参数(最多 2 个参数:计数器路径与采样间隔),再调用 get_perf_counter_value_by_path() 读取计数器的英文名路径值(PERF_COUNTER_LANG_EN)。perf_counter_en 的优势在于使用英文计数器名,避免因 Windows 显示语言不同导致计数器路径解析失败。物理磁盘发现使用的 perf_instance_discovery_en 同样位于该文件(perf_instance_discovery_ex 实现)。

4.3 内存与交换监控

监控项 Key 说明
Total memory / Used memory vm.memory.size[total] / vm.memory.size[used] 字节
Memory utilization vm.memory.size[pused] %,驱动 {$MEMORY.UTIL.MAX}
Cache bytes perf_counter_en["\Memory\Cache Bytes"] 系统缓存字节数(仅显示最后观测值)
Context…(见上) — —
Free swap space system.swap.size[,free] 字节
Free swap space in % system.swap.pfree(Dependent) 预处理 JavaScript return (100 - value) 反推
Used swap space in % perf_counter_en["\Paging file(_Total)\% Usage"] 分页文件使用率
Total swap space system.swap.size[,total] 字节
Free system page table entries perf_counter_en["\Memory\Free System Page Table Entries"] 空闲页表项数
Memory page faults/sec perf_counter_en["\Memory\Page Faults/sec"] 缺页速率(含硬/软缺页)
Memory pages/sec perf_counter_en["\Memory\Pages/sec"] 磁盘分页读写速率,>1000 提示内存泄漏
Memory pool non-paged perf_counter_en["\Memory\Pool Nonpaged Bytes"] 非分页池大小,>175MB(或 /3GB 开关时 100MB)提示泄漏

4.4 安全与合规监控:基于 WMI 的原始采集 + 依赖项派生

模板的安全模块采用同一套模式:一个 master item 通过 wmi.getall 拉取 WMI 类全部实例(JSON 数组),再由若干 Dependent item 用 JSON Path 提取字段并做类型转换(Boolean to decimal)、错误兜底(⛔️Custom on fail: Set value to: …)。wmi.getall 与 wmi.get 均为 Windows agent 的 WMI 查询接口(注册于 src/libs/zbxsysinfo/win32/win32.c 的 item 表中,底层由 wmi.cpp 的 zbx_wmi_get_variant 执行)。

4.4.1 TPM 与 Secure Boot

  • master:wmi.getall[root\CIMV2\Security\MicrosoftTpm,"select IsEnabled_InitialValue,IsActivated_InitialValue,IsOwned_InitialValue,SpecVersion,ManufacturerVersion from Win32_Tpm"](Discard unchanged 1d);
  • 派生项:tpm.presence、tpm.enabled、tpm.activated、tpm.owned、tpm.spec.version、tpm.manufacturer.version;
  • 注意:经典 agent 不调用 WMI 方法,状态取自最近一次 provisioning/clear 事件时快照的 *_InitialValue 属性;
  • Secure Boot:registry.data[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecureBoot\State,UEFISecureBootEnabled](0=禁用,1=启用)。传统 BIOS/CSM 主机上该注册表键不存在,该项会变为 NOTSUPPORTED,此时需在主机上设 {$WINDOWS.SECURITY.SECUREBOOT.IGNORE}=1 抑制告警。

4.4.2 Windows 激活与 KMS

  • master:SoftwareLicensingProduct(过滤 ApplicationID='55c92734-d682-4d71-983e-d6ec3f16059f' 的 Windows 产品)与 SoftwareLicensingService(KMS 配置);
  • 派生项:activation.license.status(0=未授权…6=延长宽限期)、activation.grace(自定义倍数 ×60 换算为秒)、activation.product.name、activation.product.key(末 5 位)、activation.status.reason、activation.kms.server、activation.kms.port、activation.client.id、activation.kms.host。

4.4.3 Microsoft Defender

  • master:wmi.getall[root\Microsoft\Windows\Defender,"select … from MSFT_MpComputerStatus"];
  • 派生项:defender.amservice.enabled、defender.rtp.enabled、defender.av.enabled、defender.as.enabled(均 Boolean to decimal)、defender.av.signature.age、defender.as.signature.age、defender.quickscan.age("Never scanned" 归一到 -3,见 YAML 中 Data quality 值映射)、defender.fullscan.age、defender.av.signature.version。

4.4.4 Windows 更新(KB)

  • master:wmi.getall[root\cimv2,"select HotFixID,Description,InstalledOn,Caption from Win32_QuickFixEngineering"];
  • 派生项:updates.kb.total、updates.kb.security(描述为 "Security Update" 的数量)、updates.kb.last.id、updates.kb.last.date、updates.kb.days、updates.security.last.date、updates.security.days,均由 JavaScript 从原始 JSON 计算。

5. 触发器(Triggers)与告警策略

5.1 固定触发器清单(非发现类)

触发器 表达式要点 级别 备注
Active checks are not available min(…zabbix[host,active_agent,available],{$AGENT.TIMEOUT})=2 High 主动检查长时间不可用
Zabbix agent is not available nodata(…agent.ping,{$AGENT.NODATA_TIMEOUT})=1 Average 需手动关闭
High CPU utilization min(…system.cpu.util,5m)>{$CPU.UTIL.CRIT} Warning —
CPU interrupt time is too high min(…% Interrupt Time,5m)>{$CPU.INTERRUPT.CRIT.MAX} Warning 依赖 High CPU utilization
CPU privileged time is too high min(…% Privileged Time,5m)>{$CPU.PRIV.CRIT.MAX} Warning 依赖 interrupt / 高 CPU
CPU queue length is too high min(…Processor Queue Length,5m) - last(…NumberOfLogicalProcessors)*2 > {$CPU.QUEUE.CRIT.MAX} Warning 按"核数×2"经验法则动态扣除
High memory utilization min(…vm.memory.size[pused],5m)>{$MEMORY.UTIL.MAX} Average —
Free system page table entries too low max(…,5m)<{$MEM.PAGE_TABLE_CRIT.MIN} Warning 依赖高内存
Memory Pages/sec too high min(…,5m)>{$MEM.PAGE_SEC.CRIT.MAX} Warning 依赖高内存
High swap space usage max(…system.swap.pfree,5m)<{$SWAP.PFREE.MIN.WARN} and last(…system.swap.size[,total])>0 Warning 无交换分区时自动忽略(total=0)
Host has been restarted last(…system.uptime)<10m Warning 需手动关闭
System name has changed change(…system.hostname) and length(last(…))>0 Info 需手动关闭
OS description has changed change(…system.sw.os) and length(last(…))>0 Info 需手动关闭,依赖系统名变更
TPM is not present last(…tpm.presence)=0 Info TPM 为 BitLocker/VBS/Win11 就绪所需
SecureBoot is disabled last(…registry.data[…UEFISecureBootEnabled])=0 and {$WINDOWS.SECURITY.SECUREBOOT.IGNORE}=0 Warning 合法无 Secure Boot 的主机请置 IGNORE=1
Is not licensed last(…activation.license.status)<>1 Warning 非 Licensed 状态即告警
Activation grace period running out last(…activation.grace)>0 and last(…)<{$WINDOWS.SECURITY.ACTIVATION.GRACE.MIN.WARN} Warning 宽限期即将耗尽
Defender real-time protection is off last(…defender.rtp.enabled)=0 Average 实时防护关闭
Defender signatures are out of date min(…defender.av.signature.age,5m)>{$WINDOWS.SECURITY.DEFENDER.SIGNATURE.MAX.WARN} Warning —
Defender full scan overdue last(…defender.fullscan.age)>{$WINDOWS.SECURITY.DEFENDER.FULLSCAN.MAX.WARN} Warning —
No KB installed recently last(…updates.kb.days)>{$WINDOWS.UPDATES.STALE.MAX.WARN} Warning 更新停滞
No Security KB installed recently last(…updates.security.days)>{$WINDOWS.UPDATES.SECURITY.STALE.MAX.WARN} Average 安全更新停滞

5.2 触发器间的依赖关系(告警风暴抑制)

模板在 YAML 的 triggers: 段(L4491 起)为触发器定义了 Depends on 依赖,实现告警收敛。典型链路:

  • 中断时间告警 → 依赖 CPU 利用率告警;
  • 特权时间告警 → 依赖中断时间 + CPU 利用率告警;
  • 页表项 / Pages/sec 告警 → 依赖内存利用率告警;
  • 交换空间告警 → 依赖内存利用率告警;
  • 文件系统、网络、磁盘等发现类告警 → 依赖各自父级告警(如下)。

6. 自动发现(LLD)规则详解

模板共内置 7 条 LLD 规则,全部在 YAML 的 discovery_rules: 段(L1726 起)定义。发现类监控通过过滤器(filter)、宏上下文与触发依赖实现了精细控制。

6.1 Windows scheduled tasks discovery(计划任务)

  • LLD key:task.discovery(Dependent,master 为 MSFT_ScheduledTask WMI 类);
  • 设计要点:默认不发现任何任务——Windows 原生约 200 个计划任务,必须显式设置 {$WINDOWS.TASK.NAME.MATCHES} 才会发现(避免海量无意义监控项);
  • 健壮性:Task Scheduler WMI 命名空间不可用时 master 返回空列表,因而不创建任何监控项,而不是产生 unsupported 项;
  • Item prototype:task.state["{#TASK.URI}"](JSON Path 按 URI 匹配 State);
  • Trigger prototype:{$WINDOWS.TASK.CONTROL:"{#TASK.NAME}"}=1 and last(…task.state["{#TASK.URI}"])=1 → "Scheduled task … is disabled"(Warning,需手动关闭)。

6.2 Windows Firewall: Profiles discovery(防火墙配置)

  • LLD key:firewall.profiles.discovery(master:MSFT_NetFirewallProfile);
  • Item prototypes:firewall.enabled["{#FW.PROFILE}"]、firewall.inbound["{#FW.PROFILE}"]、firewall.outbound["{#FW.PROFILE}"](均 JSON Path 匹配 Name);
  • Trigger prototype:last(…firewall.enabled["{#FW.PROFILE}"])<>1 → "Firewall [{#FW.PROFILE}] is disabled"(Warning);
  • 发现范围由 {$WINDOWS.SECURITY.FW.PROFILE.MATCHES}(默认 Domain/Private/Public)控制。

6.3 Mounted filesystem discovery(文件系统)

  • LLD key:vfs.fs.get[short](Zabbix agent active;Discard unchanged 6h);
  • 两级采集模型:为每个发现的文件系统建立 master 项 vfs.fs.get[full,{#FSNAME}](JSON Path $[0] 取出该卷),再派生 5 个依赖项:vfs.fs.dependent.size[{#FSNAME},free|total|used|pused|pfree],分别以 JSON Path $.bytes.free/.total/.used/.pused/.pfree 提取;
  • Trigger prototypes(均需手动关闭):
    • 空间低(Warning):{$FSCONTROL:"{#FSNAME}"}=1 and min(…pused,5m)>{$VFS.FS.PUSED.MAX.WARN:"{#FSLABEL}({#FSNAME})"};
    • 空间严重不足(Average):阈值换为 {$VFS.FS.PUSED.MAX.CRIT:…},且依赖上面的空间低告警;
  • 上下文宏技巧:{$FSCONTROL:"{#FSNAME}"}=0 可永久屏蔽某卷(如只读媒体卷);阈值宏支持 {#FSNAME} 或 {#FSLABEL}({#FSNAME}) 两种上下文形式。

6.4 Windows BitLocker: Volume discovery(BitLocker 卷)

  • LLD key:bitlocker.volume.discovery(master:Win32_EncryptableVolume;对 any error 错误兜底返回 [],BitLocker 不可用的主机不会产生 unsupported 项);
  • Item prototypes:bitlocker.protection["{#FSNAME}"]、bitlocker.method["{#FSNAME}"]、bitlocker.conversion["{#FSNAME}"](JSON Path 按 DriveLetter 匹配;失败兜底值分别为 2/0/0);
  • 值映射(见 YAML valuemaps: 段 L4270 起):
    • 保护状态:0=Protection off、1=Protection on、2=Protection unknown;
    • 加密方法:0=None、1=AES 128 with Diffuser、2=AES 256 with Diffuser、3=AES 128、4=AES 256、5=Hardware encryption、6=XTS-AES 128、7=XTS-AES 256;
    • 转换状态:0=Fully decrypted、1=Fully encrypted、2=Encryption in progress、3=Decryption in progress、4=Encryption paused、5=Decryption paused;
  • Trigger prototype:last(…bitlocker.protection["{#FSNAME}"])<>1 → "BitLocker {#FSNAME} is not enabled on enforced volume"(Average)——仅对 {$WINDOWS.SECURITY.BITLOCKER.ENFORCE.MATCHES}(默认 ^C:$,即强制加密 C 盘)命中的卷生效。

6.5 Network interfaces discovery(网络接口)

  • LLD key:net.if.discovery(Dependent,master 为 win32_networkadapter 物理网卡 WMI 查询,过滤 PhysicalAdapter=True and NetConnectionStatus>0;Discard unchanged 1h);
  • Item prototypes(统一以 {#IFGUID} 定位接口):
    • net.if.in["{#IFGUID}"] / net.if.out["{#IFGUID}"]:入/出流量,预处理 Change per second + 自定义倍数 ×8(字节/秒 → 比特/秒);
    • net.if.in["{#IFGUID}",dropped|errors]、net.if.out["{#IFGUID}",dropped|errors]:丢包/错误包速率(Change per second);
    • net.if.type["{#IFGUID}"]、net.if.status["{#IFGUID}"]、net.if.speed["{#IFGUID}"]:类型、运行状态、带宽(JSON Path 提取;speed 对 9223372036854775807 兜底为 0);
  • Trigger prototypes:
    • Link down(Average,需手动关闭):{$IFCONTROL:"{#IFNAME}"}=1 and last(…status)<>2 and (last(…,#1)<>last(…,#2))——三条件设计:接口启用且非"未连接"、且状态发生过变化(不误报"常年未接"的接口);文档提示:若手动关闭,因 .diff 特性同一状态不会再触发;
    • High bandwidth usage(Warning):(avg(…in,15m)>({$IF.UTIL.MAX:"{#IFNAME}"}/100)*last(…speed) or avg(…out,15m)>(…)) and last(…speed)>0;
    • High error rate(Warning):入/出错误包 5 分钟均值超 {$IF.ERRORS.WARN:"{#IFNAME}"},恢复条件为降至阈值 80% 以下;
    • Ethernet speed decreased(Info):change(…speed)<0 and last(…speed)>0 and last(…status)=2,提示自协商(autonegotiation)异常。

6.6 Physical disks discovery(物理磁盘)

  • LLD key:perf_instance_discovery_en[PhysicalDisk],预处理 Replace {#INSTANCE} -> {#DEVNAME},把 PDH 实例名重命名为设备名;
  • Item prototypes(采样间隔 60 秒):读/写队列长度、当前队列长度(avgqu-sz)、读/写速率(Disk Reads/sec、Disk Writes/sec)、读/写平均响应时间(Avg. Disk sec/Read、Avg. Disk sec/Write)、磁盘利用率——后者通过 % Idle Time 计数器取 100 - value 反算;
  • Trigger prototypes(均需手动关闭):
    • 读/写响应过慢:min(…Avg. Disk sec/Read,15m) > {$VFS.DEV.READ.AWAIT.WARN:"{#DEVNAME}"}(默认 0.02s),预示磁盘饱和;
    • 磁盘过载:min(…% Idle Time,15m)>{$VFS.DEV.UTIL.MAX.WARN}(默认 95% 繁忙),依赖读写响应告警。

6.7 Windows services discovery(服务)

  • LLD key:service.discovery(Zabbix agent active),服务过滤完全由宏驱动(见 3.7);
  • Item prototype:service.info["{#SERVICE.NAME}",state];
  • Trigger prototypes:
    • "…is not running"(Average):min(…service.info[…],#3)<>0 and last(…system.uptime)>{$SERVICE.STARTUP.GRACE:"{#SERVICE.NAME}"}——连续 3 次采样非运行 且 已过启动宽限期(默认 10m)才告警;
    • "…must not be running"(Warning):仅对 {$SERVICE.FORBIDDEN.MATCHES} 列出的服务发现,min(…,#3)=0 表示其连续运行——适用于"必须保持停止"的服务(如安全扫描要求禁用的遗留服务)。

7. 实战调优建议

  1. 主动模式心跳阈值:{$AGENT.NODATA_TIMEOUT} 保持 30m 级别(README 明确提示"keep it relatively high"),避免短暂网络波动即触发"agent 不可用"。
  2. 计划任务与服务的发现收敛:先设 {$WINDOWS.TASK.NAME.MATCHES} 为具体任务名(如 ^Zabbix.*$)控制发现范围;服务发现默认只监控自动启动的服务,并可用 {$SERVICE.FORBIDDEN.MATCHES} 反向盯防"不应运行的服务"。
  3. 上下文宏做精细化治理:对特定卷 {$FSCONTROL:"D:"}=0、对特定接口 {$IFCONTROL:"Loopback"}=0、对特定服务 {$SERVICE.STARTUP.GRACE:"MySQL"}=20m,均可独立于全局阈值生效。
  4. 文件系统发现默认只收固定盘({$VFS.FS.FSDRIVETYPE.MATCHES}=fixed),如需监控光盘/移动介质,需调整该宏并注意事件名以总卷空间为准(与最大可用空间在不同文件系统上可能有差异)。
  5. 无 TPM / 传统 BIOS 主机:设 {$WINDOWS.SECURITY.SECUREBOOT.IGNORE}=1;Secure Boot 注册表键缺失时该项变为 NOTSUPPORTED 属预期行为。
  6. 磁盘过载阈值:{$VFS.DEV.UTIL.MAX.WARN}=95 针对的是"繁忙时间占比",与读/写响应时间告警搭配使用可区分"饱和"与"慢盘"。
  7. 合规基线:激活宽限期(30d)、Defender 病毒库(7d)、全盘扫描(30d)、普通更新(45d)、安全更新(60d)构成一套开箱即用的 Windows 安全合规基线,可按企业制度调整后用于审计报表。

8. 排障速查

现象 原因与处置
zabbix[host,active_agent,available] 长期为 2 agent 未建立主动连接:核对 ServerActive 地址/端口、Hostname 与前端主机名是否一致、server trapper 端口(10051)可达性
Secure Boot 项 NOTSUPPORTED 传统 BIOS/CSM 主机无该注册表键,属预期;设 {$WINDOWS.SECURITY.SECUREBOOT.IGNORE}=1
计划任务一个都不发现 未设置 {$WINDOWS.TASK.NAME.MATCHES}(默认不发现任何任务)
BitLocker 项 unsupported master 已对 any error 兜底返回 [],正常情况下不产生 unsupported;如仍出现,检查 WMI 命名空间 root\CIMV2\Security\MicrosoftVolumeEncryption 可用性
perf_counter_en 返回 NOTSUPPORTED 计数器路径与英文名不符或性能对象不存在(如无 _Total 实例的罕见环境),可对照 src/libs/zbxsysinfo/win32/pdhmon.c 中参数校验与错误返回逻辑排查
网络接口全量发现过多 默认 master 已过滤 PhysicalAdapter=True,再用 {$NET.IF.IFNAME.NOT_MATCHES} 等宏剔除虚拟适配器

9. 参考资料

模板反馈与问题上报:可参考模板 README 末尾的 Feedback 章节(support.zabbix.com 与 ZABBIX forums)。

登录后查看全文
zabbix