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

Обзор

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

Настройка

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

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

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

Поля, которые требуют указания информации, специфичной для траппер элемента данных:

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

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

Zabbix sender

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

zabbix_sender -z <IP адрес сервера> -p 10051 -s "New host" -k trap -o "тестовое значение"

Чтобы отправить «тестовое значение», используются следующие опции команды:

• -z — чтобы указать IP адрес Zabbix сервера
• -p — чтобы указать номер порта Zabbix сервера (по умолчанию 10051)
• -s — чтобы указать узел сети (убедитесь, что используете здесь «техническое» имя узла сети вместо «видимого» имени)
• -k — чтобы указать ключ элемента данных, настроенного в траппер элементе данных
• -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. Это может произойти по следующим причинам:

• пользователь, отправляющий данные, не имеет права чтения на узел сети элемента данных;
• узел отключён или находится в состоянии обслуживания без сбора данных;
• элемент данных не существует или ещё не включён в кэш конфигурации сервера;
• элемент данных отключён или его тип отличается от Zabbix траппер или HTTP агент (с включённой опцией «Активировать трапы»);
• IP или DNS пользователя не указаны в списке Разрешённые хосты элемента данных;
• другой элемент данных имеет значение с дублирующейся временной меткой на уровне наносекунд.

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

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

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

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