Zabbix icmpping键值使用报错咨询及实用示例求助

报错根因说明 #

你碰到的ZBX_NOTSUPPORTED: Unsupported item key错误基本由以下两类问题导致：

• 调用对象错误：icmpping、icmppingsec、icmppingloss三个ICMP检测类键是Zabbix Server/Proxy原生内置的服务端键，不属于Zabbix Agent的支持键。你用zabbix_get请求Agent端自然会返回不支持，Web端配置时如果把监控项类型选成「Zabbix客户端」也会报同样错误。
• 依赖缺失：Zabbix的ICMP检测底层依赖fping工具，Server/Proxy端未安装fping的情况下，就算配置对类型也会报错。

可直接复用的配置示例 #

前置准备 #

先完成Server/Proxy端的基础配置：

• 安装fping依赖：
  • Debian/Ubuntu系：apt install fping
  • RHEL/CentOS系：yum install fping
• 确认Zabbix Server配置文件（默认路径/etc/zabbix/zabbix_server.conf）中FpingLocation参数配置正确，默认值为FpingLocation=/usr/sbin/fping，修改后需重启zabbix-server服务生效。

键值参数说明 #

icmpping完整语法为icmpping[<目标地址>,<数据包数量>,<数据包间隔>,<数据包大小>,<超时时间>]，除目标地址外其余参数均可留空使用默认值：

• 数据包数量默认值：3
• 数据包间隔默认值：1000ms
• 数据包大小默认值：56字节（ICMP载荷，加包头总大小64字节）
• 超时时间默认值：500ms

返回值说明：icmpping仅返回0/1（0=不可达，1=可达），需要返回延迟值请用icmppingsec，需要返回丢包率请用icmppingloss。

实用示例 #

1. 最简可达性检测

键值：icmpping[142.251.128.68]

2. 自定义参数检测（匹配你的测试需求：10个包、间隔500ms、包大小64字节、超时100ms）

• 检测可达性：icmpping[142.251.128.68,10,500,64,100]
• 检测平均延迟：icmppingsec[142.251.128.68,10,500,64,100]
• 检测丢包率：icmppingloss[142.251.128.68,10,500,64,100]

3. 命令行调试方式

不要用zabbix_get请求Agent，直接在Zabbix Server端用内置测试命令验证：
zabbix_server -R runtime_control test_item "icmppingsec[142.251.128.68,10,500,64,100]" -v
Proxy端可替换为zabbix_proxy的对应测试命令。

Web端配置注意事项 #

• 监控项类型必须选*「Zabbix内部检查」*，不能选Zabbix客户端、客户端主动式等其他类型
• 不需要填写客户端IP，内部检查由Server/Proxy端主动执行

内容的提问来源于stack exchange，提问作者Raul Chiarella