使用 Zabbix "DELL PowerEdge R820 by HTTP" 模板基于 Redfish API 监控戴尔服务器
使用 Zabbix "DELL PowerEdge R820 by HTTP" 模板基于 Redfish API 监控戴尔服务器
本篇技术指南围绕 Zabbix 官方提供的 DELL PowerEdge R820 by HTTP 监控模板展开,该模板面向搭载 iDRAC 8/9(固件 4.32 及更高版本)并已启用 Redfish API 的 DELL PowerEdge R820 服务器,全部通过 Zabbix Script 类型监控项直接采集数据,无需任何外部脚本。读完本文,你将掌握该模板的部署步骤、全部宏与监控项/触发器/自动发现规则的用法,并能从仓库源码层面理解其 HTTP 请求与数据处理实现原理。
模板概览
该模板存放于仓库 templates/server/dell/dell_r820_http/ 目录,由两个文件组成:
- README.md:官方使用说明(本文主体);
- template_server_dell_r820_http.yaml:模板的完整 YAML 导出文件(约 3900 行),由 Zabbix 官方模板工具 "Templator" 生成,可用于直接导入。
从 YAML 头部可以看到模板的归属信息:模板名称为 DELL PowerEdge R820 by HTTP,所属模板组为 Templates/Server hardware,导出格式版本为 8.0,模板版本为 8.0-4(见 template_server_dell_r820_http.yaml)。
适用前提:
- Zabbix 版本:8.0 及以上;
- 服务器:DELL PowerEdge R820(模板已在 R820 上测试通过);
- iDRAC 固件:8/9 系列、4.32 及更高版本,且已在 iDRAC 界面中启用 Redfish API。
工作原理概述:模板通过 Script 类型监控项,使用 JavaScript(运行于 Zabbix 内置 JS 引擎)向 iDRAC 的 Redfish 接口发起带 Basic Auth 的 HTTPS 请求,拉取系统信息、传感器、存储、电源、风扇、网络等资源;再由 Dependent(依赖)监控项通过 JSONPath/JavaScript 预处理从原始 JSON 中提取指标;最后通过多条 LLD(低级别自动发现)规则把温度、电源、风扇、阵列卡、电池、物理盘、虚拟盘、网口等动态资源自动展开为具体监控项与触发器。
部署与配置步骤
按照 README.md 的 Setup 章节,部署流程如下:
- 启用 Redfish API:在服务器 iDRAC 管理界面中启用 Redfish API;
- 创建只读监控用户:在 iDRAC 界面中为监控创建只读权限用户;
- 创建主机:在 Zabbix 前端创建戴尔服务器主机,将 iDRAC 的 IP 作为 Zabbix agent 接口(该模板依赖 Zabbix 服务器发起 Script 与简单检查,接口类型配置为 agent 即可);
- 链接模板:将
DELL PowerEdge R820 by HTTP模板链接到该主机; - 配置宏:为
{$DELL.HTTP.API.URL}、{$DELL.HTTP.API.USER}、{$DELL.HTTP.API.PASSWORD}三个宏填写实际值。
注意:如果某些执行请求的监控项出现超时,请相应调整
{$DELL.HTTP.REQUEST.TIMEOUT}宏的值(YAML 中该宏默认值为10s)。
在 YAML 中,宏还携带了向导化(wizard)配置元数据:{$DELL.HTTP.API.URL}、{$DELL.HTTP.API.USER}、{$DELL.HTTP.API.PASSWORD} 均被标记为必填(required: YES),其中密码宏的类型为 SECRET_TEXT(以密钥形式存储),优先级按 URL(1) → 用户名(2) → 密码(3) 排序,见 template_server_dell_r820_http.yaml。这意味着在 Zabbix 8.0 及以上版本中,导入该模板后可直接通过向导界面引导式填写这三项参数。
宏定义详解
模板使用以下宏(默认值与说明见 README.md 的 "Macros used" 小节):
| 宏名称 | 说明 | 默认值 |
|---|---|---|
{$DELL.HTTP.API.URL} |
Dell iDRAC Redfish API 地址,格式为 <scheme>://<host>:<port> |
无(必填) |
{$DELL.HTTP.API.USER} |
Dell iDRAC 用户名 | 无(必填) |
{$DELL.HTTP.API.PASSWORD} |
Dell iDRAC 用户密码 | 无(必填) |
{$DELL.HTTP.PROXY} |
需要时为 Redfish API 请求设置 HTTP 代理 | 空 |
{$HTTP.TLS.VERIFY} |
Script 监控项的 TLS 证书校验级别:none 关闭、peer 校验证书链与有效期、full 全量校验;其他任意值等同 full。仅针对本模板覆盖时,可用带上下文宏 {$HTTP.TLS.VERIFY:"DELL PowerEdge"} |
full |
{$DELL.HTTP.RETURN.CODE.OK} |
视为 API 正常响应的 HTTP 返回码,默认 200;例如使用代理时可能不同 |
200 |
{$DELL.HTTP.REQUEST.TIMEOUT} |
HTTP 请求超时时间 | 10s |
{$DELL.HTTP.IFCONTROL} |
仅当网口上下文宏等于 1 时才触发链路状态触发器 |
1 |
{$DELL.HTTP.CPU.UTIL.HIGH} |
CPU 使用率 "high" 告警阈值(百分比) | 90 |
{$DELL.HTTP.CPU.UTIL.WARN} |
CPU 使用率 "warning" 告警阈值(百分比) | 75 |
{$DELL.HTTP.MEM.UTIL.HIGH} |
内存使用率 "high" 告警阈值(百分比) | 90 |
{$DELL.HTTP.MEM.UTIL.WARN} |
内存使用率 "warning" 告警阈值(百分比) | 75 |
{$DELL.HTTP.IO.UTIL.HIGH} |
IO 使用率 "high" 告警阈值(百分比) | 90 |
{$DELL.HTTP.IO.UTIL.WARN} |
IO 使用率 "warning" 告警阈值(百分比) | 75 |
{$DELL.HTTP.SYS.UTIL.HIGH} |
SYS 使用率 "high" 告警阈值(百分比) | 90 |
{$DELL.HTTP.SYS.UTIL.WARN} |
SYS 使用率 "warning" 告警阈值(百分比) | 75 |
从 YAML 的宏定义块(template_server_dell_r820_http.yaml)还可以看到更多实现细节:
- 各利用率阈值宏被归入
Thresholds配置分区,且带正则约束^-?([0-9]+|(([0-9]+)\.([0-9]+)))$,即只接受整数或小数(官方描述注明取值应在 0~100 之间); {$DELL.HTTP.IFCONTROL}、{$DELL.HTTP.PROXY}、{$DELL.HTTP.REQUEST.TIMEOUT}、{$DELL.HTTP.RETURN.CODE.OK}归入Other分区;{$HTTP.TLS.VERIFY}在向导中渲染为下拉列表(LIST 类型),可选值full(全量校验)、peer(仅证书链)、none(关闭),并附有安全提示:关闭校验会使连接暴露于中间人攻击,仅应在端点使用自签名证书时关闭。
监控项与数据采集原理
模板内置 14 个常规监控项(见 README.md 的 "Items" 小节),分为三类:Script 型主监控项、Dependent 型依赖监控项、Simple 型简单检查。
主监控项(Script 类型)
| 名称 | 说明 | Key |
|---|---|---|
| Get system | 返回系统指标 | dell.server.system.get |
| Get sensors | 返回传感器数据 | dell.server.sensors.get |
| Get array controller resources | 返回阵列控制器资源 | dell.server.array.resources.get |
| Get disks | 返回存储资源 | dell.server.disks.get |
| Get network interfaces | 返回网络接口 | dell.server.net.iface.get |
在 YAML 中,这些 Script 监控项均声明了 timeout: '{$DELL.HTTP.REQUEST.TIMEOUT}',并通过 parameters 将宏值作为 JSON 参数传入脚本,参数名包括 http_proxy、http_status_code、password、tls_verify、url、user(见 template_server_dell_r820_http.yaml)。dell.server.disks.get 与 dell.server.net.iface.get 的更新间隔为 1h(第 221-228 行、第 466-473 行),其余 Script 主监控项没有固定延迟(默认随依赖需求刷新)。
所有 Script 监控项共享同一套 JavaScript 实现骨架,其核心逻辑可从 dell.server.system.get 的脚本(template_server_dell_r820_http.yaml)中归纳:
- 参数校验:
validateZabbixParams检查url、user、password、http_status_code等必填参数,缺失即抛错; - TLS 配置:
CTlsConfig将{$HTTP.TLS.VERIFY}映射为SSLVerifyPeer(peer/full时开启)与SSLVerifyHost(仅full时开启);若开启校验而 URL 不是https://,会直接抛出提示,要求改用 HTTPS 或把该校验宏设为none; - 请求执行:
Dell.executeRequest基于 Zabbix 内置HttpRequest对象,先添加Authorization: Basic <btoa(user:password)>头(即 Basic 认证),若配置了代理则调用setProxy;随后request.get(url + apiPath)发起请求,并用request.getStatus() === parseInt(http_status_code)校验返回码,不一致时记录日志并抛错; - 数据处理:
extractData将响应 JSON 解析后,按给定字段路径(如Model、Oem.Dell.DellSystem.ChassisServiceTag、Status.Health、FirmwareVersion)抽取字段并拼装为返回对象。
dell.server.system.get 实际访问两个 Redfish 端点并合并结果:/redfish/v1/Systems/System.Embedded.1(取 model、serialnumber、status)与 /redfish/v1/Managers/iDRAC.Embedded.1(取 FirmwareVersion)。
各主监控项对应的 Redfish 端点(可从脚本源码确认):
| 监控项 | Redfish 端点 | 备注 |
|---|---|---|
| Get system | /redfish/v1/Systems/System.Embedded.1、/redfish/v1/Managers/iDRAC.Embedded.1 |
模型/序列号/健康状态/固件 |
| Get sensors | /redfish/v1/Chassis/System.Embedded.1/Sensors?$expand=.($levels=1) |
一次展开全部传感器 |
| Get array controller resources | /redfish/v1/Systems/System.Embedded.1/Storage?$expand=.($levels=1) |
筛选 Id 含 "RAID" 的控制器 |
| Get disks | /redfish/v1/Systems/System.Embedded.1/Storage 及各控制器子资源 |
依次抓取 Drives 与 Volumes |
| Get network interfaces | /redfish/v1/Chassis/System.Embedded.1/NetworkAdapters 及各端口子资源 |
遍历适配器与端口 |
其中 Get sensors 脚本的传感器分类逻辑值得一提(第 837-853 行):名称以 PS 开头且 PhysicalContext 为 PowerSupply 的归入 PSU 列表;ReadingType 为 Temperature 的归入温度列表;名称含 Fan 且 ReadingType 为 Rotational 的归入风扇列表;名称含 System Board 且 ReadingType 为 Percent 的归入系统板利用率列表。随后分别经 formatPSU(按电源名聚合电压/电流读数与健康度)、formatTemp(去掉温度名称末位单词)、formatSysBoard(去掉 "System/Board/Usage" 等词)清洗后返回。
依赖监控项与预处理
依赖监控项以主监控项为数据源,通过预处理从 JSON 中提取具体指标:
| 名称 | Key | 预处理 |
|---|---|---|
| CPU utilization, in % | dell.server.util.cpu |
JSONPath:$.sysBoard[?(@.id == "SystemBoardCPUUsage")].reading.first() |
| Memory utilization, in % | dell.server.util.mem |
JSONPath:$.sysBoard[?(@.id == "SystemBoardMEMUsage")].reading.first() |
| IO utilization, in % | dell.server.util.io |
JSONPath:$.sysBoard[?(@.id == "SystemBoardIOUsage")].reading.first() |
| SYS utilization, in % | dell.server.util.sys |
JSONPath:$.sysBoard[?(@.id == "SystemBoardSYSUsage")].reading.first() |
| Overall system health status | dell.server.status |
JSONPath $.status → JavaScript 映射(OK=1/Warning=2/Critical=3,其余=0)→ 6h 心跳去重 |
| Hardware model name | dell.server.hw.model |
JSONPath $.model → 6h 心跳去重(并自动关联主机资产字段 MODEL) |
| Hardware serial number | dell.server.hw.serialnumber |
JSONPath $.serialnumber → 6h 心跳去重(关联资产字段 SERIALNO_A) |
| Firmware version | dell.server.hw.firmware |
JSONPath $.firmware → 6h 心跳去重 |
例如 dell.server.util.cpu 的定义见 template_server_dell_r820_http.yaml,其 master_item 指向 dell.server.sensors.get。利用率监控项单位为 %(units: '%'),健康状态监控项则关联 Redfish status health 值映射。
简单检查:Redfish API 可用性
监控项 Redfish API status(Key:net.tcp.service<a href="https://link.gitcode.com/i/87970cb97aca568619a01d7e2ae667f0" target="_blank">https],类型 Simple check)用于探测服务器上 Redfish API 的可用性:0 - 不可用,1 - 可用,并关联 Redfish API availability 值映射(见 [template_server_dell_r820_http.yaml)。
触发器与告警策略
模板内置 13 个常规触发器(见 README.md 的 "Triggers" 小节),覆盖资源利用率、整体健康状态与硬件变更:
| 触发器名称 | 表达式(要点) | 级别 | 备注 |
|---|---|---|---|
| CPU utilization is too high | min(...,5m)>={$DELL.HTTP.CPU.UTIL.HIGH} |
High | |
| CPU utilization is high | min(...,5m)>={$DELL.HTTP.CPU.UTIL.WARN} |
Warning | 依赖"too high"触发器 |
| Memory utilization is too high | min(...,5m)>={$DELL.HTTP.MEM.UTIL.HIGH} |
High | |
| Memory utilization is high | min(...,5m)>={$DELL.HTTP.MEM.UTIL.WARN} |
Warning | 依赖"too high"触发器 |
| IO utilization is too high | min(...,5m)>={$DELL.HTTP.IO.UTIL.HIGH} |
High | |
| IO utilization is high | min(...,5m)>={$DELL.HTTP.IO.UTIL.WARN} |
Warning | 依赖"too high"触发器 |
| SYS utilization is too high | min(...,5m)>={$DELL.HTTP.SYS.UTIL.HIGH} |
High | |
| SYS utilization is high | min(...,5m)>={$DELL.HTTP.SYS.UTIL.WARN} |
Warning | 依赖相关"too high"触发器 |
| Server is in a critical state | last(dell.server.status)=3 |
Average | 整体健康为 Critical |
| Server is in a warning state | last(dell.server.status)=2 |
Warning | 依赖 critical 触发器 |
| Device has been replaced | 序列号 #1 与 #2 取值不同且长度>0 |
Info | 需手动关闭 |
| Firmware has changed | 固件版本 #1 与 #2 取值不同且长度>0 |
Info | 需手动关闭 |
| Redfish API service is unavailable | last(net.tcp.service[https])=0 |
High |
利用率类触发器统一使用 min(...,5m) 取 5 分钟最小值与阈值宏比较,起到抑制瞬时抖动的作用;"Device has been replaced"(设备被替换)与 "Firmware has changed"(固件变更)属于资产变更类告警,设计为手动确认关闭(manual_close: YES),触发条件中 length(...)>0 用于防止序列号/固件字段为空时误报。在 YAML 中还可看到这些触发器带 scope 标签(capacity/availability/notice)以及 opdata 动态展示当前值(如 Current value: {ITEM.LASTVALUE1})。
低级别自动发现(LLD)规则
模板通过 8 条 LLD 规则把动态变化的硬件资源自动展开为监控项与触发器(各规则均以 Dependent 类型、6h 心跳去重预处理驱动,详见 README.md)。
1. Temperature discovery(温度)
- 主发现项 Key:
dell.server.temp.discovery,预处理 JSONPath$.temperature; - 原型监控项:
Probe [{#SENSOR_NAME}]: Get sensor(Keydell.server.sensor.temp.get[{#SENSOR_NAME}],JSONPath 按{#ID}取$.temperature.[?(@.id == '{#ID}')].first())、Value($.reading)、Status($.health经 JavaScript 映射为 OK/Warning/Critical); - 原型触发器:
Probe [{#SENSOR_NAME}]: Critical state(Average)、Probe [{#SENSOR_NAME}]: Warning state(Warning,依赖前者)。
2. PSU discovery(电源)
- 主发现项 Key:
dell.server.psu.discovery,预处理 JSONPath$.psu; - 原型监控项:
Power supply [{#SENSOR_NAME}]: Get sensor(按{#SENSOR_NAME}匹配$.psu.[?(@.name == '{#SENSOR_NAME}')].first())、Voltage($.voltage.reading)、Voltage sensor status($.voltage.health)、Current($.current.reading)、Current sensor status($.current.health); - 原型触发器:电压/电流各自的 Critical(Average)与 Warning(Warning,依赖对应 Critical)共 4 条。
3. FAN discovery(风扇)
- 主发现项 Key:
dell.server.fan.discovery,预处理 JSONPath$.fan; - 原型监控项:
Fan [{#SENSOR_NAME}]: Get sensor(按{#ID}匹配)、Speed($.reading)、Status($.health); - 原型触发器:
Fan [{#SENSOR_NAME}]: Critical state(Average)、Warning state(Warning)。
4. Array controller discovery(阵列控制器)
- 主发现项 Key:
dell.server.array.discovery,预处理 JSONPath$.arrayControllers; - 原型监控项:
Controller [{#CNTLR_NAME}]: Status($.arrayControllers[?(@.id == "{#ID}")].health.first()); - 原型触发器:Critical(Average)/ Warning(Warning)。
5. Battery discovery(阵列卡电池)
- 主发现项 Key:
dell.server.controller.battery.discovery,预处理 JSONPath$.batteryControllers; - 原型监控项:
Battery [{#BATTERY_NAME}]: Status($.batteryControllers[?(@.id == "{#ID}")].status.first()); - 原型触发器:Critical(Average)/ Warning(Warning)。
6. Physical disk discovery(物理磁盘)
- 主发现项 Key:
dell.server.physicaldisk.discovery,预处理 JSONPath$.physicalDisks; - 原型监控项:
Physical disk [{#DISK_NAME}]: Get disk(Script 类型,Keydell.server.hw.physicaldisk.get[{#DISK_NAME}])、Status($.health)、Serial number($.sn)、Model name($.model)、Media type($.mediaType,取值 HDD/SSD/SMR/null)、Size($.capacity,单位字节); - 原型触发器:Critical(Average)/ Warning(Warning)、
Physical disk [{#DISK_NAME}] has been replaced(Info,手动关闭,基于序列号变化)。
7. Virtual disk discovery(虚拟磁盘 / RAID 卷)
- 主发现项 Key:
dell.server.virtualdisk.discovery,预处理 JSONPath$.virtualDisks; - 原型监控项:
Virtual disk [{#DISK_NAME}]: Get disk(Script 类型)、Status($.health)、RAID status($.raidStatus,取值 Blocked/Degraded/Failed/Foreign/Offline/Online/Ready/Unknown/null)、Size($.capacity)、Current state($.status,取值 Enabled/Disabled/StandbyOffline/StandbySpare/InTest/Starting/Absent/UnavailableOffline/Deferring/Quiesced/Updating/Qualified)、Read policy($.readCachePolicy,ReadAhead/NoReadAhead/AdaptiveReadAhead)、Write policy($.writeCachePolicy,WriteThrough/WriteBack/ProtectedWriteBack/UnprotectedWriteBack); - 原型触发器:Critical(Average)/ Warning(Warning)、
RAID status not OK(last(...)<8,Average,即 RAID 状态映射值低于 "Ready")。
8. Network interface discovery(网络接口)
- 主发现项 Key:
dell.server.net.if.discovery,仅做6h心跳去重;LLD 宏{#IFNAME}、{#ODATA}通过lld_macro_paths从$.id、$.path取值(见 template_server_dell_r820_http.yaml); - 原型监控项:
Interface [{#IFNAME}]: Get interface(Script 类型,Keydell.server.net.if.get[{#IFNAME}],通过path参数{#ODATA}指向具体端口资源,抽取LinkStatus、Status.Health、Status.State、CurrentLinkSpeedMbps)、Speed($.linkSpeed× 1000000 转为 bps)、Link status($.linkStatus)、State($.state)、Status($.health); - 原型触发器(详见 README.md 的说明):
- Link down(Average,手动关闭):
{$DELL.HTTP.IFCONTROL:"{#IFNAME}"}=1 and (last(...)=2 and last(...,#1)<>last(...,#2))——仅当操作状态变为 Down(2)、上下文宏为 1 且此前状态不同(排除"从未 up 过"的端口)时触发;需注意若手动关闭,因.diff特性下次轮询不会再触发; - Link status issue(Average,手动关闭):状态为 Null(1)/Unknown(0) 时触发,条件逻辑同上;
- Critical state(Average)/ Warning state(Warning,依赖前者)。
- Link down(Average,手动关闭):
值映射与预处理机制
模板定义了多张值映射表(见 template_server_dell_r820_http.yaml),把数值状态翻译为可读文本:
| 值映射名 | 数值 → 文本 |
|---|---|
Redfish status health |
0=Unknown,1=OK,2=Warning,3=Critical |
Redfish API availability |
0=Unavailable,1=Available |
Network interface status |
0=Unknown,1=Null,2=Down,3=Up |
Redfish status state |
0=Unknown,1=Enabled,2=Disabled,3=Absent,4=Deferring,5=InTest,6=Quiesced,7=StandbyOffline,… |
文本型健康/状态字段的转换依靠统一的 JavaScript 预处理片段完成,例如:
const idx = {
'OK': 1,
'Warning': 2,
'Critical': 3,
};
return typeof idx[value] === 'undefined' ? 0 : idx[value];
即把字符串健康状态映射为数值后由值映射表反向展示,同时便于触发器用 last(...)=3 / =2 做数值比较。这类"JSONPath 取值 → JavaScript 映射 → 6h 心跳去重"的预处理三段式在模板的各个依赖监控项中被反复使用。
内置仪表盘与图形
YAML 末尾部分声明了模板自带的可视化资源:
- 仪表盘:名称为
Overview,包含 CPU、Memory、IO、SYS 四组 gauge(仪表盘)组件,各自绑定dell.server.util.cpu/dell.server.util.mem/dell.server.util.io/dell.server.util.sys监控项(template_server_dell_r820_http.yaml); - 图形:
Dell R820: CPU utilization、Dell R820: IO utilization、Dell R820: Memory utilization、Dell R820: SYS utilization四张折线图(第 3899-3927 行); - 网络接口发现规则下还定义了
Interface [{#IFNAME}]: Speed的图形原型。
常见问题与注意事项
- 请求超时:若部分执行请求的监控项(Script 类型)超时,首先增大
{$DELL.HTTP.REQUEST.TIMEOUT}(默认 10s)。Script 监控项的timeout字段直接引用该宏。 - TLS 校验与自签名证书:iDRAC 若使用自签名证书,可将
{$HTTP.TLS.VERIFY}设为none,或仅针对本模板使用上下文宏{$HTTP.TLS.VERIFY:"DELL PowerEdge"}覆盖;但需知晓关闭校验会引入中间人攻击风险。脚本在开启校验时会强制要求 HTTPS URL,否则直接抛错。 - HTTP 返回码:如果经过代理等原因导致成功响应码不是 200,请调整
{$DELL.HTTP.RETURN.CODE.OK}。 - 链路告警抑制:
{$DELL.HTTP.IFCONTROL:"{#IFNAME}"}上下文宏置 0 可让指定网口不参与 Link down / Link status issue 告警;且这两类触发器基于.diff设计,手动关闭后需状态再次变化才会重新触发。 - 资产变更类告警:"Device has been replaced" 与 "Firmware has changed" 需要人工确认,确认后如数值不变不会自动恢复。
- 版本前提:本模板要求 Zabbix 8.0 及以上版本;Script 监控项依赖 Zabbix 内置 JavaScript 引擎提供的
HttpRequest对象,属于 Zabbix 原生能力,无需部署任何外部脚本或插件。
如需反馈模板问题或参与讨论,可参照 README.md 结尾的 Feedback 章节;同类戴尔服务器模板(R660/R720/R740/R750/R840 等,含 HTTP 与 SNMP 两种采集方式)也一并存放于 templates/server/dell/,可作为横向参考。