Zabbix 官方模板实战：使用 SNMP 全面监控 APC Smart-UPS SRT 8000 不间断电源

• 指标监控
• 可观测性
• 告警
• 运维

本指南以 Zabbix 仓库内置的官方模板APC Smart-UPS SRT 8000 by SNMP为核心，系统讲解如何通过 SNMPv2 协议接入 APC Smart-UPS SRT 8000 的网络管理卡（NMC），采集市电输入、电池健康、输出负载、相位参数与外部传感器数据，并利用内置触发器实现电池低电量、高温、输入电压/频率越界、UPS 旁路/电池供电等关键告警。读完本文，你将掌握该模板的完整部署流程、全部宏与监控项含义、自动发现机制以及底层数据预处理原理，可直接落地到生产机房的 UPS 监控体系中。

模板概览与适用场景

APC Smart-UPS SRT 8000 是 APC 面向数据中心与关键负载的高端在线互动式（Smart-UPS）机型，通过 AP9640 / AP9641 等网络管理卡（NMC）提供 SNMP 管理能力。Zabbix 为其提供开箱即用的官方模板，位于仓库 templates/power/apc/apc_ups_smart_srt_8000_snmp/ 目录，核心定义文件为 template_power_apc_ups_smart_srt_8000_snmp.yaml。

该模板覆盖三类 MIB：

• PowerNet-MIB：APC 私有 MIB（企业子树1.3.6.1.4.1.318），承载 UPS 身份、电池、输入输出等全部核心指标；
• SNMPv2-MIB：提供sysUpTime、sysName、sysLocation、sysContact等系统基础信息；
• HOST-RESOURCES-MIB：提供hrSystemUptime，用于区分“硬件启动时间”与“网络管理部分启动时间”。

模板 YAML 头部声明其由官方模板工具 "Templator" 生成，wizard_ready: 'YES'，即支持通过 Zabbix 主机向导一键创建并自动链接。

注意：README 明确建议，为保证模板正常工作，请将 NMC 固件升级到最新版本。

前置要求与兼容性

除本机型外，仓库 templates/power/apc/ 目录下还提供 Galaxy 3500、Smart 2200/3000、Smart RT 系列、Symmetra 系列等多个 APC 模板，结构完全一致，可参照本文思路复用。

快速部署：三步接入

1. 创建 SNMPv2 主机

在 Zabbix 前端进入Configuration → Hosts → Create host，填写主机名，并在 Interfaces 中添加类型为SNMP的接口：

• SNMP version：选择SNMPv2
• IP address / DNS：填写 APC Smart-UPS SRT 8000 的管理 IP（NMC 地址）
• Port：默认161
• Community：与 NMC 上配置的只读 community 一致

2. 链接模板

在主机配置页的Templates字段中链接模板APC Smart-UPS SRT 8000 by SNMP。链接后模板内的 20 余个监控项、触发器、自动发现规则及仪表盘会立即生效。

3. 按需定制宏

模板内置了 10 个用户宏，用于控制触发器的阈值与时间窗口。如果机房供电环境特殊（例如电压不稳、负载长期偏高），可在Macros选项卡中覆盖默认值，无需修改模板本身。

宏（Macros）详解

模板定义的宏如下（默认值直接取自模板定义，在 template_power_apc_ups_smart_srt_8000_snmp.yaml 的macros段落中可看到其分组、优先级与正则校验）：

从 YAML 的宏定义还可看到细节：阈值类宏（如{$BATTERY.CAPACITY.MIN.WARN}、{$UPS.OUTPUT.MAX.WARN}）声明了取值范围约束（0–100），并带有正则校验^-?([0-9]+|(([0-9]+)\.([0-9]+)))$，防止在主机向导中输入非法字符；宏按Thresholds（阈值）与Other（其他）两个分组组织，优先级编号决定了向导中的展示顺序。

监控项（Items）详解

模板通过 SNMP agent 类型监控项采集数据，并按主题分为几组。以下为完整清单（含 OID 与预处理信息，OID 均来自模板 YAML）：

身份与资产信息

说明：上表 OID 省略了 PowerNet-MIB 企业前缀1.3.6.1.4.1.318，例如 Model 的完整 OID 为1.3.6.1.4.1.318.1.1.1.1.1.1.0，后续各表同理。

电池状态与健康

输入侧（市电）

输出侧（负载）

系统基础信息（SNMPv2-MIB / HOST-RESOURCES-MIB）

值得注意的细节：system.hw.uptime设置了CHECK_NOT_SUPPORTED预处理，当设备不支持该 OID（返回any error）时将值置为0并继续采集，避免整条链路因单个 OID 不支持而失败；snmptrap.fallback使用日志格式hh:mm:sszyyyy/MM/dd，用于兜底接收未匹配的陷阱报文。资产类监控项（名称、位置、联系人）通过inventory_link自动回填主机资产字段。

触发器（Triggers）与告警策略

模板内置触发器分为“固定监控项触发器”与“LLD 原型触发器”两类，完整清单如下：

固定触发器

几个关键设计点：

• 电压/频率触发器采用“先排除 0 值再比较”的模式（min(...)>0 and (...)），避免设备在初始化瞬间上报 0 值造成误报；同时用min/max在{$TIME.PERIOD}（默认 15 分钟）窗口内分别捕捉越上界与越下界两种情形。
• "Host has been restarted"触发器是模板中最复杂的表达式：它同时检测硬件 uptime 与网络 uptime，当探测到计数回退且前一值未接近 32 位计数器上限（约 497 天）时触发，并设置了恢复表达式——uptime 超过{$SNMP.UPTIME.WARN}即自动关闭。它还依赖 "No SNMP data collection"（依赖关系防止 SNMP 中断时误判重启）。
• 部分触发器设置了event_name与opdata，事件名与操作数据中直接携带当前值与阈值（如Current temperature: {ITEM.LASTVALUE1}），便于告警通知中直接看到实测数据。

自动发现（LLD）与原型监控

针对可插拔、数量可变的组件，模板使用 6 条 LLD 规则动态生成监控项，轮询周期均为 1 小时：

输入/输出相位发现

相位电压均附带原型触发器"Unacceptable phase {#PHASEINDEX} input/output voltage"（High 级别），复用{$UPS.INPUT_VOLT.MIN.WARN}/{$UPS.INPUT_VOLT.MAX.WARN}阈值，对三相输入的每一相独立告警。

外部电池包发现

每个电池包/电池芯原型生成 5 个监控项：Battery status、Battery temperature（乘数 0.1）、Serial number、Battery estimated replace date、Battery pack cartridge health。其中两个状态型监控项以 16 位比特串形式上报，原型触发器用正则判断：

• find(...,"regexp","^(0{16})$")=0→Battery status is not okay（Warning）：只要 16 位状态串非全 0 即告警。比特位含义：bit 0 Disconnected、bit 1 Overvoltage、bit 2 NeedsReplacement、bit 3 OvertemperatureCritical、bit 4 Charger、bit 5 TemperatureSensor、bit 6 BusSoftStart、bit 7 OvertemperatureWarning、bit 8 GeneralError、bit 9 Communication、bit 10 DisconnectedFrame、bit 11 FirmwareMismatch。
• find(...,"regexp","^(0)[0|1]{15}$")=1→Battery lifetime is not okay（Warning）：当健康度首比特为 0 且后续 15 位存在置位（即寿命异常位被标记）时告警。健康位含义：bit 0 寿命正常、bit 1 寿命接近终点请订购、bit 2 寿命已超期请更换、bit 3/4 已确认的对应状态、bit 5/6 实测寿命相关状态。

另有Battery has high temperature原型触发器（High 级别），复用{$BATTERY.TEMP.MAX.WARN}。

外部传感器发现

每个已发现的外部传感器（如温湿度探头）生成 3 个监控项：

• {#EXTERNAL_SENSORx_NAME}: Temperature sensor（℃，-1 表示通信丢失导致的无效读数）
• {#EXTERNAL_SENSORx_NAME}: Humidity sensor（相对湿度 %，-1 表示不支持湿度或通信丢失）
• {#EXTERNAL_SENSORx_NAME}: Sensor alarm status（Normal=1/Warning=2/Critical=3/Not applicable=4）

对应 3 个原型触发器：Sensor has status Critical（High）、Warning（Average）、Not Applicable（Info，表示传感器未工作或未连接）。模板还针对传感器端口设置了 LLD override：当发现宏{#EXTERNAL_SENSORx_NAME}包含 "Temp" 时，跳过名称含 "Humidity" 的项（NO_DISCOVER），避免纯温度探头产生无意义的湿度监控项。

数据预处理原理

模板大量使用两种预处理步骤，理解其原理有助于调优：

• Custom multiplier（自定义倍数）：PowerNet-MIB 中upsHighPrec*系列 OID 为保留一位小数的定点数（如电压上报2428表示 242.8V），因此乘数0.1；upsAdvBatteryRunTimeRemaining以百分之一秒计，乘数0.01换算为秒。该步骤在 Zabbix Server 端预处理流水线中由ZBX_PREPROC_MULTIPLIER分支执行（见 src/libs/zbxpreproc/pp_execute.c），经过宏展开后调用乘法实现，得到真实物理量后按监控项声明的单位（V/Hz/A/%/℃/s）展示。
• Discard unchanged with heartbeat（心跳去重）：对变化缓慢的指标（如型号、序列号、位置、输出状态）设置6h/12h心跳，值不变时不写入历史数据库，显著降低存储开销；而快速变化的电压、频率、负载等指标不启用该步骤，保证曲线完整。

此外，Uptime (hardware)使用Check for not supported value（失败时自定义值为0）预处理，将不支持的 OID 优雅降级为 0，这是模板健壮性的体现。

值映射与可读性

模板在 YAML 的valuemaps段定义了 6 张值映射表，把原始数字转换为可读文本：

• PowerNet-MIB::upsBasicBatteryStatus：1=Unknown、2=Normal、3=Low、4=In Fault Condition
• PowerNet-MIB::upsBasicOutputStatus：1=Unknown、2=Online、3=On Battery、4=On Smart Boost、5=Timed Sleeping、6=Software Bypass、7=Off、8=Rebooting、9=Switched Bypass、10=Hardware Failure Bypass、11=Sleeping Until Power Return、12=On Smart Trim、13=Eco Mode、14=Hot Standby、15=On Battery Test、16=Emergency Static Bypass、17=Static Bypass Standby、18=Power Saving Mode、19=Spot Mode、20=E-Conversion、21=Charger Spotmode、22=Inverter Spotmode、23=Active Load、24=Battery Discharge Spotmode、25=Inverter Standby、26=Charger Only
• PowerNet-MIB::upsAdvBatteryReplaceIndicator：1=no Battery Needs Replacing、2=battery Needs Replacing
• PowerNet-MIB::upsAdvInputLineFailCause：no Transfer / High Line Voltage / Brownout / Blackout / Small/Deep Momentary Sag / Small/Large Momentary Spike / Self Test / Rate of Voltage Change
• PowerNet-MIB::uioSensorStatusAlarmStatus：Normal / Warning / Critical / Not applicable
• zabbix.host.available：not available / available / unknown

正是由于值映射的存在，input.fail这类枚举型监控项才能直接看到 "Blackout"、"Brownout" 等语义化结果，配合 "Host has been restarted"、"No SNMP data collection" 触发器，可以快速还原市电跌落事件的全貌。

内置仪表盘与图形

模板附带一个名为APC Smart-UPS SRT 8000: General的仪表盘（YAMLdashboards段），包含三张预定义图形：

• Voltage（电压）：叠加input.voltage与output.voltage两条线，直观对比市电输入与 UPS 稳压输出；
• Capacity of the UPS batteries（电池容量）：饼图展示battery.capacity当前占比；
• Output（输出）：叠加output.current与output.load，观察负载电流与负载百分比的关系。

链接模板后，这些图形会自动出现在主机的 Dashboards 中，无需手工创建。

部署验证与排障

接入完成后建议按以下顺序验证：

1. 打开Latest data，确认Model、Serial number、Battery status等资产/状态项已返回非空值；若出现 "Not supported"，先用snmpwalk -v2c -c <community> <IP> 1.3.6.1.4.1.318.1.1.1在命令行验证 OID 可达性。
2. 观察Uptime (hardware)与Uptime (network)是否持续增长；若硬件 uptime 不支持（被预处理置 0），不影响其余指标。
3. 检查Problems中是否出现 "No SNMP data collection"，该触发器由内部监控项zabbix[host,snmp,available]驱动，在{$SNMP.TIMEOUT}（默认 5 分钟）内连续不可用即告警。
4. 人为断开市电测试：应依次看到 "UPS is on battery"（Average）→ 若持续停电则 "Battery is Low"（Average）→ 容量跌破阈值触发 "Battery has low capacity"（High），同时Input fail cause值映射显示为 Blackout 或 Brownout。
5. 确认相位发现是否生效：进入Discovery rules，查看 Input/Output phases discovery 的执行结果，三相设备应生成 3 组{#PHASEINDEX}原型项。

若模板行为与预期不符，优先核对 NMC 固件版本（README 明确要求使用最新固件）与 SNMP community 权限。同时，仓库中的同族模板（如 apc_ups_smart_srt_5000_snmp）可作为对比参考，帮助定位是设备能力差异还是配置问题。

• 指标监控
• 可观测性
• 告警
• 运维