6 Zabbix trapper

概述

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

配置

要配置 trapper 监控项：

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

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

trapper 监控项需要填写的特定字段如下：

发送数据

向Zabbix server 或 proxy发送数据可以使用Zabbix sender 程序或Zabbix sender protocol。 向Zabbix server发送数据还可以使用API方法 history.push 。

Zabbix sender

使用Zabbix sender程序向Zabbix server 或 proxy发送数据时，您可以运行以下命令来发送“测试值”:

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

发送“测试值”，可以使用以下命令选项:

• -z 指定Zabbix server的IP地址
• -p 指定Zabbix server的端口（默认为10051）
• -s 指定主机（请确保在此使用“主机名称”，非“可见的名称” host name)
• -k 要指定在监控项中配置trapper监控项键值configured
• -o 指定要发送的实际值

10051了解更多关于Zabbix sender与 Zabbix server 或 proxy之间通信的信息。参见 Zabbix sender protocol.

history.push

使用 API 方法history.push 向 Zabbix server发送数据时，您可以发起以下包含一些测试值的 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的验证。 这种情况可能由以下原因导致：

• 发送数据的用户没有对该监控项主机的“读取”权限;
• 主机被禁用或处于维护期且没有数据采集;
• 监控项不存在或尚未包含在服务器配置缓存中;
• 监控项被禁用或其类型不是Zabbix trapper 或 HTTP agent (启用 trapping );
• 用户的IP或DNS不在监控项的允许主机 列表中;
• 另一个监控项有一个在纳秒级别上具有重复时间戳的值.

没有错误表明发送的值已被接受处理，这包括预处理（若配置预处理）、触发器处理以及保存到数据库中。 请注意，即使值已被接受处理，处理过程也可能会失败（例，在 预处理期间），导致该值被丢弃。 关于获取更多如何使用Zabbix API信息，请参见 API.

显示数据

数据发送后，您可以导航到 Monitoring > Latest data 查看结果：