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

Обзор

В этом разделе приведена подробная информация о пассивных и активных проверках, выполняемых агентом Zabbix и агентом Zabbix 2.

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

Протоколы агента Zabbix и агента Zabbix 2 унифицированы начиная с Zabbix 7.0. Различие между запросами и ответами агента Zabbix и агента Zabbix 2 выражается значением тега "variant".

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

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

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

Опросчик агента попытается подключиться ко всем адресам, возвращенным при поиске DNS. Это гарантирует, что если один IP-адрес недоступен, опросчик попробует следующий доступный адрес, повышая вероятность успешного подключения. Это улучшение применяется как к серверу Zabbix, так и к прокси.

Максимальное количество одновременно выполняемых асинхронных проверок — 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. Сервер отправляет <HEADER><DATALEN>{"request":"passive checks","data":[{"key":"agent.ping","timeout":3}]}
3. Агент считывает запрос и отвечает <HEADER><DATALEN>{"version":"7.0.0","variant":2,"data":[{"value":1}]}
4. Сервер обрабатывает данные, чтобы получить значение — в нашем случае «1»
5. TCP-соединение закрывается

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

1. Сервер открывает TCP-соединение
2. Сервер отправляет <HEADER><DATALEN>{"request":"passive checks","data":[{"key":"vfs.fs.size[/nono]","timeout":3}]}
3. Агент считывает запрос и отвечает <HEADER><DATALEN>{"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 agent 7.0.

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

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

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

{
  "request": "active checks",
  "host": "Zabbix server",
  "host_metadata": "mysql,nginx",
  "interface": "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
    }
  ]
}

Сервер должен ответить с результатом success.

Например:

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": "8495cd52070e6ca52b371f29c8574165",
  "host": "Zabbix server",
  "version": "7.0.0",
  "variant": 2
}

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

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

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

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

Например:

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

Сообщение проверки доступности

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

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

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

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

Ответ с перенаправлением

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

  {
    "response": "failed",
    "redirect": {
      "revision": 2,
      "address": "192.0.2.1:10055"
    }
  }

Старый протокол XML