3. Пассивные и активные проверки агента

Обзор

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

Для взаимодействия с Zabbix агентом Zabbix использует протокол на основе JSON.

Смотрите также: Подробная информация о протоколе Zabbix агента 2.

Пассивные проверки

Пассивная проверка - это простой запрос данных. Zabbix сервер или прокси запрашивает какие-либо данные (например, загрузку CPU), и Zabbix агент отправляет результат обратно серверу.

Запрос сервера

За определением длины заголовка и данных, пожалуйста, обратитесь к подробностям протокола.

<ключ элемента данных>

Ответ агента

<ДАННЫЕ>[\0<ОШИБКА>]

Часть в квадратных скобках выше опциональна и отправляется только по неподдерживаемым элементам данных.

Например, для поддерживаемых элементов данных:

1. Сервер открывает TCP-соединение
2. Сервер отправляет: <ЗАГОЛОВОК><ДЛИНАДАННЫХ>agent.ping
3. Агент читает запрос и отвечает: <ЗАГОЛОВОК><ДЛИНАДАННЫХ>1
4. Сервер обрабатывает данные, чтобы извлечь значение, в нашем случае «1»
5. TCP-соединение закрывается

Для неподдерживаемых элементов данных:

1. Сервер открывает TCP-соединение
2. Сервер отправляет: <ЗАГОЛОВОК><ДЛИНАДАННЫХ>vfs.fs.size[/nono]
3. Агент читает запрос и отвечает: <ЗАГОЛОВОК><ДЛИНАДАННЫХ>ZBX_NOTSUPPORTED\0Cannot obtain filesystem information: [2] No such file or directory
4. Сервер обрабатывает данные, меняет состояние элемента данных на неподдерживаемое с приведённым сообщением об ошибке
5. TCP-соединение закрывается

Активные проверки

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

Серверы для получения активных проверок перечислены в параметре 'ServerActive' файла конфигурации агента. Частота запросов данных проверок настраивается параметром 'RefreshActiveChecks' в этом же файле конфигурации. Однако, если обновление активных проверок завершится с ошибкой, запрос повторится через 60 секунд (жёстко задано в коде).

Затем агент периодически отправляет новые значения на сервер(ы).

Получение списка элементов данных

Запрос агента

Запрос на активные проверки используется для получения списка активных проверок, обрабатываемых агентом. Этот запрос отсылается агентом после старта и затем с интервалом RefreshActiveChecks .

{
         "request": "active checks",
         "host": "Zabbix server",
         "host_metadata": "mysql,nginx",
         "hostinterface": "zabbix.server.lan",
         "ip": "159.168.1.1",
         "port": 12050
       }

Ответ сервера

Ответ активных проверок посылается сервером обратно агенту после обработки запроса на активные проверки.

{
         "response": "success",
         "data": [
           {
             "key": "log[/home/zabbix/logs/zabbix_agentd.log]",
             "key_orig": "log[/home/zabbix/logs/zabbix_agentd.log]",
             "itemid": 1234,
             "delay": "30s",
             "lastlogsize": 0,
             "mtime": 0
           },
           {
             "key": "agent.version",
             "key_orig": "agent.version",
             "itemid": 5678,
             "delay": "10m",
             "lastlogsize": 0,
             "mtime": 0
           }
         ]
       }

Сервер обязан ответить успешно.

Например:

1. Агент открывает TCP-соединение
2. Агент запрашивает список проверок
3. Сервер отвечает списком элементов данных (ключ элемента данных, интервал обновления)
4. Агент анализирует ответ
5. TCP-соединение закрывается
6. Агент начинает периодический сбор данных

Отправка собранных данных

Агент отправляет

Запрос агента с данными содержит собранные значения элементов данных.

{
         "request": "agent data",
         "data": [
           {
             "host": "Zabbix server",
             "key": "agent.version",
             "value": "2.4.0",
             "clock": 1400675595,
             "ns": 76808644
           },
           {
             "host": "Zabbix server",
             "key": "log[/home/zabbix/logs/zabbix_agentd.log]",
             "lastlogsize": 112,
             "value": " 19845:20140621:141708.521 Starting Zabbix Agent [<hostname>]. Zabbix 2.4.0 (revision 50000).",
             "clock": 1400675595,
             "ns": 77053975
           }
         ],
         "session": "1234456akdsjhfoui"
       }

Каждому значению назначается виртуальный ID. Значение ID - простой возрастающий счётчик, уникальный в пределах одной сессии данных (идентифицируемой токеном сессии). Этот ID используется, чтобы отбрасывать дубликаты значений, которые могли быть отосланы в средах с плохой связью.

Ответ сервера

Ответ на данные агента отсылается сервером назад агенту после обработки запроса агента с данными.

{
         "response": "success",
         "info": "processed: 2; failed: 0; total: 2; seconds spent: 0.003534"
       }

Например:

1. Агент открывает TCP-соединение
2. Агент отправляет список значений
3. Сервер обрабатывает данные и отправляет обратно статус
4. TCP-соединение закрывается

Обратите внимание на то, как в примере выше указывается неподдерживаемое состояние для vfs.fs.size[/nono] при помощи значения "state", равного 1, и сообщения об ошибке в свойстве "value".

Более старый XML протокол