【免费下载链接】community-templatesZabbix Community Templates repository项目地址https://gitcode.com/gh_mirrors/co/community-templates点击查看免费下载本文以 community-templates 仓库中的 UPS HDS 模板说明文档 为主体结合 6.0 版模板文件 的完整导出内容逐条解析该模板的 11 个采集项、2 个值映射、1 个宏以及 README 未提及的 2 个电池容量触发器。读完本文你可以直接将该模板导入 Zabbix 6.0或 5.4 / 5.0 对应版本完成一台基于 SNMPv2 协议的 UPS不间断电源设备的全维度监控部署。模板概览SNMPv2 采集方式与适用版本UPS HDS 模板由社区作者 Carlos Eduardo 提交见 README 的 Author 章节采集方式为SNMPv2。模板归属 Zabbix 主机组Templates导出于2021-11-21不包含任何模板链接template links也不包含任何自动发现规则discovery rules——这与 README 中 There are no template links / no discovery rules 的声明一致从模板文件结构看其zabbix_export顶层也确实只有templates单一定义。仓库中该模板提供三个版本目录可按你的 Zabbix 版本选择导入版本目录文件适用 Zabbix6.0/template_ups-hds.yaml README.mdZabbix 6.05.4/template_ups-hds.yamlZabbix 5.45.0/template_ups-hds.xmlZabbix 5.0README 概述章节列出的采集信息共 11 项设备名称、设备位置、Uptime、电池状态、电源输出状态、电池电压、温度°C、输入电力频率、输入电压、电池容量、电池负载UPS 负载。下面逐项对照模板文件给出 OID、更新间隔、单位与预处理等完整细节。采集项Items逐项解析以下表格完整继承 README 的 Items collected 列表并从 6.0 YAML 中补充了 OID、单位、历史记录/趋势周期、预处理和标签信息。所有 Item 的采集类型均为SNMP_AGENT即通过被管设备的 SNMP Agent 轮询。设备基础信息名称、位置与运行时长Item 名称KeyOID更新间隔说明Name DevicesysNameRFC1213-MIB::sysName.086400s设备名称CHAR 类型history 30d禁用 trends绑定库存字段NAMEDevice LocationsysLocationRFC1213-MIB::sysLocation.086400s描述机房/网点位置TEXT 类型禁用 trends绑定库存字段LOCATIONUptimesysUpTimeRFC1213-MIB::sysUpTime.0600s单位uptimetrends 180d这三个 Item 来自标准 RFC1213-MIB 系统组 MIB采集间隔设置为 1 天86400s属于低频变化的静态信息Uptime则每 10 分钟刷新一次用于跟踪设备在线时长。电池相关状态、容量、电压与温度Item 名称KeyOID更新间隔单位说明Status bateria电池状态upsBaseBatteryStatus.0.1.3.6.1.4.1.935.1.1.1.2.1.1.0120s—绑定值映射UPS Battery Statustrends 180dVoltagem Bateria电池电压upsBatteryVoltage.0UPS-MIB::upsBatteryVoltage.01800sVoltstrends 180dCapacidade da Bateria电池容量upsSmartBatteryCapacityRFC1213-MIB::mib-2.33.1.2.4.0120s%history 180d、trends 180d挂载 2 个触发器Temperatura UPSUPS 温度upsSmartBatteryTemperature.0.1.3.6.1.4.1.935.1.1.1.2.2.3.0900s°C预处理MULTIPLIER × 0.1history 60d、trends 180d两点实现细节值得注意电池状态 Item 使用的是私有企业 OID.1.3.6.1.4.1.935.1.1.1.2.1.1.0而非 RFC 1628 标准upsBaseBatteryStatus1.3.6.1.2.1.25.3.1.1。从源码结构看作者保留了标准 MIB 的 Key 命名upsBaseBatteryStatus.0但把 OID 指向了1.3.6.1.4.1.935企业私有分支这意味着该 Item 针对 HDS 设备实际暴露的私有 OID 编写若你管理的是其他厂商的 UPS通常需要核对该设备的 MIB 后调整 OID。温度 Item 带MULTIPLIER 0.1预处理原始 SNMP 整数按 0.1 缩放后得到实际摄氏温度与 UPS-MIB 系列以 0.1°C 为精度单位的编码约定一致。电力输入、输出与负载Item 名称KeyOID更新间隔单位说明Status saída nobreak输出状态upsBaseOutputStatus.0.1.3.6.1.4.1.935.1.1.1.4.1.1.0900s—绑定值映射Status saída bateria UPStrends 180dFrequência da Energia de Entrada输入频率upsInputFrequency.1UPS-MIB::upsInputFrequency.1120sHz预处理MULTIPLIER × 0.1trends 180dVoltagem Entrada de Energia输入电压upsInputVoltage.1UPS-MIB::upsInputVoltage.1120sVoltstrends 180dCarga da UPSUPS 负载upsSmartOutputLoad.0RFC1213-MIB::mib-2.33.1.4.4.1.5.11500s%trends 180d输入频率 Item 的× 0.1预处理同样关键upsInputFrequency原始值按 10 倍放大上报如 60Hz 上报为 600乘以 0.1 后才能得到实际赫兹值。注意输入侧 OID 索引为.1对应第一个输入通道而电池电压索引为.0这是 UPS-MIB 表格型对象Table按索引取行的正常用法。Carga da UPS表示当前负载占 UPS 额定容量的百分比采集间隔 25 分钟属于慢变化指标。标签体系模板文件中每个 Item 都带有Application标签取值分三档UPSsysName / sysLocation / sysUpTime / 温度、Bateria电池状态 / 容量 / 电压 / 负载、Energia输出状态 / 输入频率 / 输入电压。在 Zabbix 6.0 中这套标签可直接用于标签筛选的仪表盘tag-based widgets把 UPS、电池、电力三个维度的指标分组呈现。值映射Value Maps把整数状态翻译成可读文本README 声明模板创建了两个值映射6.0 YAML 中给出了完整映射表。注意 YAML 中的输出状态映射比 README 多出了 79 三个取值——文章以模板文件实际内容为准。1° UPS Battery Status电池状态映射作用于 ItemupsBaseBatteryStatus.0原始值映射文本1unknown2batteryNormal3batteryLow2° Status saída bateria UPSUPS 输出状态映射作用于 ItemupsBaseOutputStatus.0原始值映射文本1unknown2onLine3onBattery4onBoost5sleeping6onBypass7rebooting8standBy9onBuck这套取值语义与 RFC 1628upsBaseOutputStatus的枚举定义一致onLine表示市电正常、UPS 在线整流输出onBattery表示已切换电池供电onBoost/onBuck表示升压 / 稳压AVR工作onBypass表示旁路输出。因此当设备进入onBattery或onBypass时配合下方触发器即可快速发现供电异常。触发器电池容量告警逻辑README 与模板文件的差异README 的 Triggers 章节写有 There are no triggers in this template但 6.0 YAML 实际在 ItemupsSmartBatteryCapacity下挂载了2 个触发器。以模板文件为准触发器名称表达式优先级含义Nível de carga em 20%last(/UPS HDS/upsSmartBatteryCapacity)20HIGH剩余容量低于 20%Nível de carga em 50%last(/UPS HDS/upsSmartBatteryCapacity)50 and last(/UPS HDS/upsSmartBatteryCapacity)20AVERAGE剩余容量介于 20%50%告警逻辑解读容量 20%时产生 HIGH 级事件属于电池即将耗尽的紧急状态通常应触发运维介入容量20%50%之间产生 AVERAGE 级事件属于提前预警窗口两个表达式之间边界清晰20与20 且 50不会同时触发容量高于 50% 时不产生任何事件触发器直接引用 Itemlast()值未使用change()或持续时长条件即状态满足即触发恢复条件为表达式取反。需要说明的是该模板没有针对upsBaseOutputStatus如 onBattery配置触发器。如果你的环境要求在 UPS 切实换电池供电时立即告警可以在导入后基于 ItemupsBaseOutputStatus.0自行补充触发器例如监测其值映射到onBattery/onBypass的状态。宏配置{$SNMP_COMMUNITY}README 的 Macros used 表格声明了唯一的一个模板宏宏名称描述默认值类型{$SNMP_COMMUNITY}—空Text macro默认值为空因此部署时有两种配置方式在主机上定义为应用了该模板的主机设置用户宏{$SNMP_COMMUNITY}为设备实际使用的 SNMP v2 社区名在模板上覆盖导入后在模板宏编辑页填写统一社区名再按主机覆盖。主机侧必须配置 SNMPv2 接口接口类型 SNMP版本 v2 并填写 Community否则所有SNMP_AGENT类型 Item 都会采集失败。模板没有为任何 Item 单独配置 SNMP 凭据全部走主机接口与宏默认链路。导入与部署面向不同 Zabbix 版本按仓库 README 的通用指引部署步骤如下按你的 Zabbix 版本选择对应文件6.0 用 Applications/template_ups-hds/6.0/template_ups-hds.yaml5.4 用 Applications/template_ups-hds/5.4/template_ups-hds.yaml5.0 用 Applications/template_ups-hds/5.0/template_ups-hds.xml在 Zabbix Web 界面导入该模板文件Configuration → Templates → Import新建主机如ups-hds-01添加 SNMP 接口并选择 SNMPv2 协议配置对应的 Community为该主机应用模板UPS HDS如未逐主机覆盖先在模板宏中设置{$SNMP_COMMUNITY}等待 12 个采集周期后检查 Item 是否出数重点核对upsBaseBatteryStatus.0/upsBaseOutputStatus.0两个私有 OID Item——若显示 Not supported说明目标设备并非 HDS 型号或未暴露该私有 MIB 分支需要参照设备自带 MIB 修改 OID。实现细节与使用注意基于模板文件源码私有 OID 分支upsBaseBatteryStatus.0、upsBaseOutputStatus.0、upsSmartBatteryTemperature.0三个 Item 的 OID 均位于1.3.6.1.4.1.935.1.1.1.x企业私有分支从源码结构看是针对 HDS 设备定制采集路径其余 8 个 Item 使用标准RFC1213-MIB/UPS-MIB命名。跨厂商复用时这三处是主要适配点。Carga da UPS的 OID 值得复核该 Item 指向RFC1213-MIB::mib-2.33.1.4.4.1.5.1而 Key 命名为upsSmartOutputLoad.0。从源码结构看作者把 MIB-2 树中1.3.6.1.2.1.33.1段的节点当作 UPS 负载来源不同厂商 MIB 中负载 OID 位置可能不同建议先用snmpget手动验证该 OID 返回值是否为百分比负载。无自动发现模板不含 discovery rules所有 Item 为固定清单。多电池、多输入通道场景下标准 UPS-MIB 支持多行 Table需要自行扩展 Key 索引或使用 LLD。README 与 YAML 的已知偏差README 称无触发器且输出状态映射只列到取值 6而模板文件实际含 2 个触发器和 9 个映射取值。本文一律以 6.0 模板文件 为准建议后续阅读时对照该文件核实。数据保留策略除文本类 Item 外数值 Item 的 trends 统一保留 180dupsSmartBatteryCapacity的 history 为 180d、温度 history 为 60d、sysNamehistory 为 30d可直接满足半年级的电池健康度趋势分析需求。参考文件README.md、template_ups-hds.yaml (6.0)、template_ups-hds.yaml (5.4)、template_ups-hds.xml (5.0)、仓库 README赞分享【免费下载链接】community-templatesZabbix Community Templates repository项目地址https://gitcode.com/gh_mirrors/co/community-templates点击查看免费下载相关推荐Zabbix Community Templates UPS HDS 模板详解通过 SNMPv2 采集 HDS 不间断电源的电池与供电状态Zabbix Community Templates UPS HDS 模板详解通过 SNMPv2 采集 HDS 不间断电源的电池与供电状态 本文基于 commZabbix 通过 SNMPv2 监控 ViPNet IDS 入侵检测系统模板「ViPNet IDS SNMPv2」完全解析Zabbix 通过 SNMPv2 监控 ViPNet IDS 入侵检测系统模板「ViPNet IDS SNMPv2」完全解析 本文围绕 Zabbix 社区模板用 Zabbix 监控 Microsoft Exchange Server 2016community-templates 服务状态模板完整解析用 Zabbix 监控 Microsoft Exchange Server 2016community templates 服务状态模板完整解析 本文以 co上一篇终极B站内容监控指南三步实现UP主动态追踪与直播提醒下一篇高效工作流革命TrafficMonitor插件生态打造Windows任务栏全能监控中心创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考