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

Обзор

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

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

Протоколы Zabbix агента и Zabbix агента 2 были унифицированы, начиная с версии Zabbix 7.0. Отличие между запросами/ответами Zabbix агента и Zabbix агента 2 выражается значением тега «variant».

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

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

Пассивные проверки выполняются асинхронно — не требуется получения ответа на один запрос до запуска других проверок. DNS резолвинг также выполняется асинхронно.

Максимальное число одновременных асинхронных проверок составляет 1000 (определяется параметром MaxConcurrentChecksPerPoller).

Количество асинхронных поллеров агента определяется параметром StartAgentPollers.

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

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

{
       "request": "passive checks",
       "data": [
       {
       "key": "agent.version",
       "timeout": 3
       }
       ]
       }

Ответ агента

{
       "version": "7.0.0",
       "variant": 2,
       "data": [
       {
       "value": "7.0.0"
       }
       ]
       }

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

1. Сервер открывает TCP-соединение
2. Сервер отправляет <ЗАГОЛОВОК><ДЛИНАДАННЫХ>{"request":"passive checks","data":[{"key":"agent.ping","timeout":3}]}
3. Агент читает запрос и отвечает: <ЗАГОЛОВОК><ДЛИНАДАННЫХ>{"version":"7.0.0","variant":2,"data":[{"value":1}]}
4. Сервер обрабатывает данные, чтобы извлечь значение, в нашем случае '1'
5. TCP-соединение закрывается

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

1. Сервер открывает TCP-соединение
2. Сервер отправляет <ЗАГОЛОВОК><ДЛИНАДАННЫХ>{"request":"passive checks","data":[{"key":"vfs.fs.size[/nono]","timeout":3}]}
3. Агент читает запрос и отвечает: <ЗАГОЛОВОК><ДЛИНАДАННЫХ>{"version":"7.0.0","variant":2,"data":[{"error":"Unsupported item key."}]}
4. Сервер обрабатывает данные, меняет состояние элемента данных на неподдерживаемое с приведённым сообщением об ошибке
5. TCP-соединение закрывается

Переключение на старый протокол

Чтобы обеспечить воможность работы Zabbix-сервера или прокси с агентами версий до 7.0, которые имеют простой текстовый протокол, реализовано переключение на старый протокол.

Пассивные проверки выполняются по протоколу JSON (7.0 и выше) после перезапуска или при изменении конфигурации интерфейса. Если в ответ не получен корректный JSON (агент отправил «ZBX_NOTSUPPORTED»), Zabbix закэширует интерфейс как старый протокол и повторит проверку, пересылая только ключ элемента данных.

Обратите внимание, что каждый час сервер/прокси Zabbix снова будет пытаться работать с новым протоколом со всеми интерфейсами, при необходимости переключаясь на старый протокол.

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

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

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

Затем агент периодически отправляет новые значения на сервер(ы). Если агент получил какие-либо удалённые команды для выполнения, также будет отправлен результат выполнения. Обратите внимание, что удалённое выполнение команд на активном агенте поддерживается, начиная с версии Zabbix агента 7.0.

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

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

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

{
       "request": "active checks",
       "host": "Zabbix server",
       "host_metadata": "mysql,nginx",
       "hostinterface": "zabbix.server.lan",
       "ip": "159.168.1.1",
       "port": 12050,
       "version": "7.0.0",
       "variant": 2,
       "config_revision": 1,
       "session": "e3dcbd9ace2c9694e1d7bbd030eeef6e"
       }

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

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

{
       "response": "success",
       "config_revision": 2,
       "data": [
       {
       "key": "system.uptime",
       "itemid": 1234,
       "delay": "10s",
       "lastlogsize": 0,
       "mtime": 0
       },
       {
       "key": "agent.version",
       "itemid": 5678,
       "delay": "10m",
       "lastlogsize": 0,
       "mtime": 0,
       "timeout": "30s"
       }
       ],
       "commands": [
       {
       "command": "df -h --output=source,size / | awk 'NR>1 {print $2}'",
       "id": 1324,
       "wait": 1
       }
       ]
       }

Ответ сервера должен быть успешным.

Например:

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

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

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

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

{
       "request": "agent data",
       "data": [
       {
       "id": 1,
       "itemid": 5678,
       "value": "7.0.0",
       "clock": 1712830783,
       "ns": 76808644
       },
       {
       "id": 2,
       "itemid": 1234,
       "value": "69672",
       "clock": 1712830783,
       "ns": 77053975
       }
       ],
       "commands": [
       {
       "id": 1324,
       "value": "16G"
       }
       ],
       "session": "1234456akdsjhfoui",
       "host": "Zabbix server",
       "version": "7.0.0",
       "variant": 2
       }

Виртуальный 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".

Сообщение heartbeat

Сообщение heartbeat («Я жив») отправляется активным агентом Zabbix серверу/прокси каждые HeartbeatFrequency секунд (настраивается в файле конфигурации Zabbix агента/ агента 2).

Используется для контроля доступности активных проверок

{
         "request": "active check heartbeat",
         "host": "Zabbix server",
         "heartbeat_freq": 60,
         "version": "7.0.0",
         "variant": 2
       }

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