Zabbix「Windows by Zabbix agent active」模板实战指南:基于主动式 Agent 的 Windows 全栈监控
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
- 在目标 Windows 主机上安装 Zabbix agent 8.0+,安装时选择主动模式配置;
- 编辑 agent 配置(Windows 上通常为
zabbix_agentd.conf),至少设置:ServerActive=<zabbix_server或proxy地址>[:port]:主动推送的服务器地址;Hostname=<host名>:须与 Zabbix 前端中该主机的名称一致(未设置时可由HostnameItem获取,见 conf/zabbix_agentd.conf 中Hostname/HostnameItem选项说明);
- 启动并验证 agent 已建立主动连接(可用模板内置
zabbix[host,active_agent,available]项观察)。
2.2 在 Zabbix 前端接入模板
- 数据采集 → 模板 → 搜索 "Windows by Zabbix agent active",导入(模板已随官方发布打包,YAML 源文件即 template_os_windows_agent_active.yaml);
- 为 Windows 主机链接模板;
- 按需在主机级或模板级覆盖宏(见下文宏清单);
- 等待第一个采集周期后即可在「最新数据」中查看监控项。
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_ScheduledTaskWMI 类); - 设计要点:默认不发现任何任务——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:…},且依赖上面的空间低告警;
- 空间低(Warning):
- 上下文宏技巧:
{$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)异常。
- Link down(Average,需手动关闭):
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表示其连续运行——适用于"必须保持停止"的服务(如安全扫描要求禁用的遗留服务)。
- "…is not running"(Average):
7. 实战调优建议
- 主动模式心跳阈值:
{$AGENT.NODATA_TIMEOUT}保持 30m 级别(README 明确提示"keep it relatively high"),避免短暂网络波动即触发"agent 不可用"。 - 计划任务与服务的发现收敛:先设
{$WINDOWS.TASK.NAME.MATCHES}为具体任务名(如^Zabbix.*$)控制发现范围;服务发现默认只监控自动启动的服务,并可用{$SERVICE.FORBIDDEN.MATCHES}反向盯防"不应运行的服务"。 - 上下文宏做精细化治理:对特定卷
{$FSCONTROL:"D:"}=0、对特定接口{$IFCONTROL:"Loopback"}=0、对特定服务{$SERVICE.STARTUP.GRACE:"MySQL"}=20m,均可独立于全局阈值生效。 - 文件系统发现默认只收固定盘(
{$VFS.FS.FSDRIVETYPE.MATCHES}=fixed),如需监控光盘/移动介质,需调整该宏并注意事件名以总卷空间为准(与最大可用空间在不同文件系统上可能有差异)。 - 无 TPM / 传统 BIOS 主机:设
{$WINDOWS.SECURITY.SECUREBOOT.IGNORE}=1;Secure Boot 注册表键缺失时该项变为 NOTSUPPORTED 属预期行为。 - 磁盘过载阈值:
{$VFS.DEV.UTIL.MAX.WARN}=95针对的是"繁忙时间占比",与读/写响应时间告警搭配使用可区分"饱和"与"慢盘"。 - 合规基线:激活宽限期(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. 参考资料
- 模板说明文档:templates/os/windows_agent_active/README.md
- 模板完整定义(monitors 全部监控项/触发器/发现规则/值映射):templates/os/windows_agent_active/template_os_windows_agent_active.yaml
perf_counter_en/perf_instance_discovery_en实现:src/libs/zbxsysinfo/win32/pdhmon.cwmi.get/wmi.getall注册表与实现:src/libs/zbxsysinfo/win32/win32.c、src/libs/zbxsysinfo/win32/wmi.cpp- 主动模式相关 agent 配置项(
ServerActive、Hostname、RefreshActiveChecks、BufferSend):conf/zabbix_agentd.conf
模板反馈与问题上报:可参考模板 README 末尾的 Feedback 章节(support.zabbix.com 与 ZABBIX forums)。