12 Trapper 监控项

概述

Trapper 监控项 接收传入的数据而不是主动查询数据。
这对于任何你想要发送到 Zabbix 的数据都非常有用。

配置

配置一个 trapper 监控项：

1. 转到 数据采集 → 主机。
2. 点击 监控项 在 主机 所在行。
3. 点击 创建监控项。
4. 在配置表单中输入 监控项 参数。

所有必填字段都用红色星号标记。

需要为 trapper 监控项 提供特定信息的字段如下：

发送数据

使用 Zabbix sender 实用程序或 Zabbix sender protocol，可以将数据发送到 Zabbix server 或 proxy。 使用 history.push 的 API 方法，也可以将数据发送到 Zabbix server。

Zabbix sender

要使用Zabbix sender工具向Zabbix server或proxy发送数据，您可以run以下命令来发送"test value":

zabbix_sender -z <server IP address> -p 10051 -s "New host" -k trap -o "test value"

发送"test value"时使用以下命令选项:

• -z 用于指定Zabbix server IP地址
• -p 用于指定Zabbix server端口号(默认为10051)
• -s 用于指定主机(确保使用技术名称而非可见的host name)
• -k 用于指定在trapper 监控项中配置的监控项键值
• -o 用于指定要发送的值

有关Zabbix sender与Zabbix server或proxy之间通信的更多信息，请参阅Zabbix sender protocol.

history.push

要将数据发送到Zabbix server，您可以使用history.push API方法发起以下包含测试值的HTTP POST请求：

curl --request POST \
         --url 'https://example.com/zabbix/api_jsonrpc.php' \
         --header 'Authorization: Bearer 0424bd59b807674191e7d77572075f33' \
         --header 'Content-Type: application/json-rpc' \
         --data '{"jsonrpc":"2.0","method":"history.push","params":[{"itemid":10600,"value":"test value 1"},{"itemid":10601,"value":"test value 2"},{"itemid":99999,"value":"test value 3"}],"id":1}'

如果请求正确，API返回的响应可能如下所示：

{
           "jsonrpc": "2.0",
           "result": {
               "response": "success",
               "data": [
                   {
                       "itemid": "10600"
                   },
                   {
                       "itemid": "10601",
                       "error": "Item is disabled."
                   },
                   {
                       "error": "No permissions to referred object or it does not exist."
                   }
               ]
           },
           "id": 1
       }

响应数据中的错误表明特定监控项的数据发送未能通过Zabbix server的验证。这可能由以下原因导致：

• 发送数据的用户没有该监控项的主机的读取权限；
• 主机已禁用或处于不收集数据的维护状态；
• 该监控项不存在或尚未包含在服务器configuration cache中；
• 该监控项已禁用或其类型不是Zabbix trapper或启用了捕获功能的HTTP agent；
• 用户的IP或DNS未设置在该监控项的允许的主机列表中；
• 另一个监控项存在纳秒级别时间戳重复的值。

没有错误表明发送的值已被接受进行处理，包括预处理（如果有）、触发器处理以及保存到数据库。请注意，已接受的值在处理过程中也可能失败（例如在preprocessing期间），导致该值被丢弃。

有关如何使用Zabbix API的更多信息，请参阅API。

显示数据

一旦数据被发送，您可以导航至 监控 → Latest data 查看结果：