6. Zabbix траппер

Обзор

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

Конфигурация

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

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

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

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

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

Отправка данных на 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.

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

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