12 Траппер элементы данных

Обзор

Элементы данных типа trapper принимают входящие данные вместо того, чтобы запрашивать их. Это полезно для любых данных, которые вы хотите отправить в Zabbix.

Настройка

Чтобы настроить траппер элемент данных:

1. Перейдите в Сбор данных → Узлы сети.
2. Нажмите Элементы данных в строке узла сети.
3. Нажмите Создать элемент данных.
4. Введите параметры элемента данных в форму конфигурации.

Все обязательные поля ввода отмечены красной звездочкой.

Поля, требующие конкретной информации для элементов траппера:

Отправка данных

Отправка данных на Zabbix сервер или прокси возможна с помощью утилиты Zabbix sender или протокола Zabbix sender. Отправка данных на сервер Zabbix также возможна с использованием метода API history.push.

Zabbix sender

Для отправки данных на сервер Zabbix или прокси с помощью утилиты Zabbix sender можно выполнить следующую команду, чтобы отправить "test value":

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

Для отправки "test value" используются следующие параметры команды:

• -z — чтобы указать IP-адрес сервера Zabbix
• -p — чтобы указать номер порта сервера Zabbix (10051 по умолчанию)
• -s — чтобы указать узел сети (убедитесь, что используется техническое, а не видимое имя узла сети)
• -k — чтобы указать ключ элемента данных, настроенного в элементе данных типа trapper
• -o — чтобы указать отправляемое значение

Для получения дополнительной информации о взаимодействии между Zabbix sender и сервером Zabbix или прокси см. протокол Zabbix sender.

history.push

Для отправки данных на сервер Zabbix с помощью метода API history.push можно выполнить следующий 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. Это может произойти по следующим причинам:

• у пользователя, отправляющего данные, нет прав read на узел сети элемента данных;
• узел сети отключён или находится на обслуживании без сбора данных;
• элемент данных не существует или ещё не включён в кэш конфигурации сервера;
• элемент данных отключён или его тип отличается от Zabbix trapper или HTTP agent (с включённым trapping);
• IP-адрес или DNS пользователя не указан в списке Allowed hosts элемента данных;
• другой элемент данных уже имеет значение с дублирующейся временной меткой на уровне наносекунд.

Отсутствие ошибок указывает на то, что отправленные значения были приняты в обработку, которая включает предобработку (если она есть), обработку триггеров и сохранение в базе данных. Обратите внимание, что обработка принятого значения также может завершиться ошибкой (например, во время предобработки), в результате чего значение будет отброшено.

Дополнительную информацию о работе с Zabbix API см. в разделе API.

Отображение данных

После отправки данных вы можете перейти к Мониторинг → Последние данные, чтобы увидеть результат: