5. Внутренняя проверка

Обзор

Внутренние проверки позволяют отслеживать внутренние процессы Zabbix. Иными словами, вы можете контролировать, что происходит с сервером Zabbix или прокси Zabbix.

Внутренние проверки вычисляются:

• На сервере Zabbix - если узел сети контролируется сервером;
• На прокси Zabbix - если узел сети контролируется прокси.

Внутренние проверки обрабатываются сервером или прокси независимо от статуса обслуживания узла сети.

Чтобы использовать этот элемент данных, выберите тип элемента данных Zabbix internal.

Производительность

Использование некоторых внутренних элементов данных может отрицательно повлиять на производительность. Речь идёт о следующих элементах данных:

• zabbix[host,,items]
• zabbix[host,,items_unsupported]
• zabbix[hosts]
• zabbix[items]
• zabbix[items_unsupported]
• zabbix[queue,,]
• zabbix[requiredperformance]
• zabbix[stats,,,queue,,]
• zabbix[triggers]

Также это влияет на разделы веб-интерфейса Информация о системе (System information) и Очередь (Queue).

Поддерживаемые проверки

Ключи элементов данных перечислены без настраиваемых параметров и дополнительной информации. Нажмите на ключ элемента данных, чтобы увидеть полную информацию.

Подробности ключа элемента данных

• Параметры без угловых скобок являются обязательными и должны использоваться как есть (например, «host» и «available» в zabbix[host,<тип>,available]).
• Параметры с угловыми скобками < > должны заменяться корректными значениями. Если параметр имеет значение по умолчанию, его можно опустить.
• Значения элементов данных и параметров элементов данных с пометкой «не поддерживаются на прокси» можно собирать только на узлах сети, которые наблюдаются через сервер. И наоборот, значения «не поддерживается на сервере» можно собирать, только если узел сети наблюдается через прокси.

zabbix[boottime]

Время запуска процесса Zabbix сервера или Zabbix прокси в секундах.
Возвращаемое значение: Целое число.

zabbix[cluster,discovery,nodes]

Обнаружение нод кластера высокой доступности.
Возвращаемое значение: Объект JSON.

Комментарии:

• Этот элемент данных можно использовать в низкоуровневом обнаружении.
• Возвращаемые поля в основном соответствуют свойствам объекта ноды высокой доутспности (High availability node).
• Дополнительные поля:
  • db_timestamp — текущее время сервера (Unix timestamp), включённое в ответ
  • lastaccess_age — секунд с последнего сигнала heartbeat ноды (db_timestamp - lastaccess)
  • status — состояние ноды:
    • 0 — горячий резерв (standby)
    • 1 — остановлен вручную
    • 2 — недоступен
    • 3 — активен

Пример возвращаемых значений:

[
  {
    "id": "ckvupihk70001z8mkpw5cg0u3",
    "name": "zabbix-prod-01",
    "status": 3,
    "address": "10.0.4.12:10051",
    "port": 10051,
    "lastaccess": 1756115995,
    "db_timestamp": 1756116000,
    "lastaccess_age": 5
  },
  {
    "id": "ckvx2a9k70004b1nq2hz9d7f",
    "name": "zabbix-standby-02",
    "status": 0,
    "address": "10.0.4.13:10051",
    "port": 10051,
    "lastaccess": 1756115550,
    "db_timestamp": 1756116000,
    "lastaccess_age": 450
  },
  {
    "id": "ckw0bq3l70007y4r1a0m5kz8",
    "name": "zabbix-backup-eu1",
    "status": 1,
    "address": "backup.example.com:10051",
    "port": 10051,
    "lastaccess": 1756105080,
    "db_timestamp": 1756116000,
    "lastaccess_age": 10920
  }
]

zabbix[connector_queue]

Количество значений, поставленных в очередь коннектора..
Возвращаемое значение: Целое число.

zabbix[discovery_queue]

Количество сетевых проверок, поставленных в очередь обнаружения.
Возвращаемое значение: Целое число.

zabbix[host,,items]

Количество активированных элементов данных (поддерживаемых и неподдерживаемых) у узла сети.
Возвращаемое значение: Целое число.

zabbix[host,,items_unsupported]

Количество активированных неподдерживаемых элементов данных у узла сети.
Возвращаемое значение: Целое число.

zabbix[host,,maintenance]

Текущее состояние обслуживания узла сети.
Возвращаемое значение: 0 — нормальное состояние; 1 — обслуживание со сбором данных; 2 — обслуживание без сбора данных.

Комментарии:

• Этот элемент данных всегда обрабатывается Zabbix сервером вне зависимости от настроек узла сети (наблюдается через сервер или прокси). Прокси не получает этот элемент данных при получении своей конфигурации.
• Второй параметр должен быть пустым и зарезервирован для использования в будущем.

zabbix[host,active_agent,available]

Доступность активных проверок агента на узле сети.
Возвращаемые значения: 0 — неизвестно; 1 — доступно; 2 — недоступно.

zabbix[host,discovery,interfaces]

Сведения по всем настроенным интерфейсам узла сети в веб-интерфейсе Zabbix.
Возвращаемое значение: Объект JSON.

Комментарии:

• Этот элемент данных можно использовать в низкоуровневом обнаружении.
• Этот элемент данных не поддерживается на Zabbix прокси.

zabbix[host,<тип>,available]

Доступность основного интерфейса определённого типа проверок на узле сети.
Возвращаемые значения: 0 — недоступен; 1 — доступен; 2 — неизвестно.

Параметры:

• тип — agent, snmp, ipmi или jmx.

Комментарии:

• Значение элемента данных вычисляется согласно параметрам конфигурации доступности/недоступности касательно узлов сети.

zabbix[hosts]

Количество наблюдаемых узлов сети.
Возвращаемое значение: Целое число.

zabbix[items]

Количество активированных элементов данных (поддерживаемых и неподдерживаемых).
Возвращаемое значение: Целое число.

zabbix[items_unsupported]

Количество неподдерживаемых элементов данных.
Возвращаемое значение: Целое число.

zabbix[java,,<param>]

Информация о Zabbix Java gateway.
Возвращаемые значения: 1 - если <param> равно ping; версия Java gateway - если <param> равно version (например: "7.0.0").

Параметры:

• param - ping или version.

Комментарии:

• Этот элемент данных можно использовать для проверки доступности Java gateway с помощью функции триггера nodata().
• Второй параметр должен быть пустым и зарезервирован для будущего использования.

zabbix[lld_queue]

Количество значений, помещённых в очередь обработки низкоуровневых обнаружений.
Возвращаемое значение: Целое число.

Комментарии:

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

zabbix[preprocessing]

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

• queued - количество и размер значений в очереди, требующих предварительной обработки (счетчик);
• direct - количество и размер значений в очереди, не требующих предварительной обработки (счетчик);
• queue - количество значений, помещенных в очередь предварительной обработки (то же, что и zabbix[preprocessing_queue]).

Возвращаемое значение: JSON.

Этот элемент данных поддерживается начиная с Zabbix 7.0.12.

Пример возвращаемых значений:

{"data":
    {
    "queued": {
        "count": 106,
        "size": 58620
    },
    "direct": {
        "count": 395,
        "size": 33843
    },
    "queue": 0
    }
}

zabbix[preprocessing_queue]

Количество значений, помещённых в очередь предварительной обработки.
Возвращаемое значение: Целое число.

Комментарии:

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

zabbix[process,<type>,<mode>,<state>]

Процент времени, который определенный процесс Zabbix или группа процессов (идентифицируемые по <type> и <mode>) провели в состоянии <state>. Вычисляется только за последнюю минуту.
Возвращаемое значение: Float.

Параметры:

• type:
  • Для процессов сервера: agent poller, alert manager, alert syncer, alerter, availability manager, browser poller, configuration syncer, configuration syncer worker, connector manager, connector worker, discovery manager, discovery worker, escalator, ha manager (since Zabbix 7.0.5), history poller, history syncer, housekeeper, http agent poller, http poller, icmp pinger, internal poller, ipmi manager, ipmi poller, java poller, lld manager, lld worker, odbc poller, poller, preprocessing manager, preprocessing worker, proxy group manager, proxy poller, self-monitoring, service manager, snmp poller, snmp trapper, task manager, timer, trapper, trigger housekeeper, unreachable poller, vmware collector;
  • Для процессов прокси: agent poller, availability manager, browser poller, configuration syncer, data sender, discovery manager, discovery worker, history syncer, housekeeper, http agent poller, http poller, icmp pinger, internal poller, ipmi manager, ipmi poller, java poller, odbc poller, poller, preprocessing manager, preprocessing worker, self-monitoring, snmp poller, snmp trapper, task manager, trapper, unreachable poller, vmware collector;
• mode:
  • avg - среднее значение для всех процессов указанного типа (по умолчанию);
  • count - возвращает количество fork-процессов для указанного типа процесса, <state> не должен быть указан;
  • max - максимальное значение;
  • min - минимальное значение;
  • <process number> - номер процесса (от 1 до количества предварительно созданных экземпляров; например, если запущено 4 trapper-процесса, значение находится в диапазоне от 1 до 4);
• state:
  • busy - процесс находится в состоянии занятости, например, обрабатывает запрос (по умолчанию);
  • idle - процесс находится в состоянии простоя и ничего не делает.

Комментарии:

• Если <mode> — это номер процесса Zabbix, который не запущен (например, при 5 запущенных poller-процессах <mode> указан как 6), такой элемент данных станет неподдерживаемым.
• Минимум и максимум относятся к проценту использования одного процесса. Поэтому если в группе из 3 poller-процессов проценты использования на процесс были 2, 18 и 66, min вернет 2, а max вернет 66.
• Процессы сообщают о том, что они делают, в разделяемой памяти, а процесс self-monitoring каждую секунду суммирует эти данные. Изменения состояния (busy/idle) регистрируются в момент изменения - таким образом, процесс, который становится busy, регистрируется как busy и не меняет и не обновляет состояние, пока не станет idle. Это гарантирует, что даже полностью зависшие процессы будут корректно зарегистрированы как 100% busy.
• В настоящее время "busy" означает "не спит", но в будущем могут быть введены дополнительные состояния - ожидание блокировок, выполнение запросов к базе данных и т. д. Обратите внимание, что начиная с Zabbix 7.0.6 асинхронные poller-процессы считаются busy, если они достигли лимита, заданного параметром конфигурации MaxConcurrentChecksPerPoller server/proxy.
• В Linux и большинстве других систем разрешение составляет 1/100 секунды.

Примеры:

zabbix[process,poller,avg,busy] #среднее время, которое процессы poller провели за последнюю минуту, выполняя работу
zabbix[process,"icmp pinger",max,busy] #максимальное время, которое любой процесс ICMP pinger провел за последнюю минуту, выполняя работу
zabbix[process,"history syncer",2,busy] #время, которое процесс history syncer номер 2 провел за последнюю минуту, выполняя работу
zabbix[process,trapper,count] #количество процессов trapper, которые в данный момент запущены

zabbix[proxy,<name>,<param>]

Информация о прокси Zabbix.
Возвращаемое значение: Integer.

Параметры:

• name - имя прокси;
• param:
  • lastaccess - отметка времени последнего сообщения heartbeat, полученного от прокси;
  • delay - как долго собранные значения остаются неотправленными; вычисляется как "задержка прокси" + ("текущее время сервера" - "последний lastaccess прокси"), где "задержка прокси" - это разница между текущим временем прокси и отметкой времени самого старого неотправленного значения на прокси.

Комментарии:

• Этот элемент данных всегда обрабатывается сервером Zabbix независимо от расположения узла сети (на сервере или прокси).
• Функцию fuzzytime() можно использовать для проверки доступности прокси.

Пример:

zabbix[proxy,"Germany",lastaccess] #отметка времени последнего сообщения heartbeat, полученного от прокси "Germany"

zabbix[proxy,discovery]

Список прокси-серверов Zabbix с именем, режимом, шифрованием, сжатием, версией, последним контактом, количеством узлов сети, количеством элементов данных, требуемыми значениями в секунду (vps), статусом версии (текущая/устаревшая/неподдерживаемая), тайм-аутами по типам элементов данных, именем группы прокси (если прокси принадлежит группе), состоянием (неизвестно/офлайн/онлайн).
Возвращаемое значение: Объект JSON.

zabbix[proxy group,<имя>,available]

Количество онлайн-прокси в группе прокси.
Возвращаемое значение: Целое число

Параметры:

• имя — имя группы прокси.

zabbix[proxy group,<имя>,pavailable]

Процент онлайн-прокси в группе прокси.
Возвращаемое значение: Число с плавающей точкой.

Параметры:

• имя — имя группы прокси.

zabbix[proxy group,<имя>,proxies]

Список прокси-серверов Zabbix в группе прокси с именем, режимом, шифрованием, сжатием, версией, последним контактом, количеством узлов сети, количеством элементов данных, требуемыми значениями в секунду (vps), статусом версии (текущая/устаревшая/неподдерживаемая), тайм-аутами, именем группы прокси, состоянием (неизвестно/офлайн/онлайн).
Возвращаемое значение: Объект JSON.

Параметры:

• имя — имя группы прокси.

zabbix[proxy group,<имя>,state]

Состояние группы прокси.
Возвращаемое значение: 0 — неизвестно; 1 — офлайн; 2 — восстановление; 3 — онлайн; 4 — деградация.

Параметры:

• имя — имя группы прокси.

zabbix[proxy group,discovery]

Возвращает список групп прокси с данными конфигурации и данными в реальном времени. Данные конфигурации включают имя группы прокси, задержку failover и минимальное количество онлайн-прокси, необходимое для работы. Данные в реальном времени включают состояние группы прокси (подробности см. в комментариях), количество онлайн-прокси и процент онлайн-прокси.
Возвращаемое значение: JSON.

Комментарии:

• Этот элемент данных не возвращает прокси без группы.
• Если для failover_delay или min_online указано недопустимое значение, то для обозначения этого возвращается специальное значение -1. Недопустимые значения могут возникать, если для конфигурации используются макросы, а макросы не могут быть раскрыты в допустимое значение.
• Состояние группы прокси возвращается как целое число: 0 - неизвестно; 1 - офлайн; 2 - восстановление; 3 - онлайн; 4 - ухудшение.

Пример возвращаемых значений:

{
    "groups": [
       { "name": "Riga", "failover_delay": 60, "min_online": 1 },
       { "name": "Tokyo", "failover_delay": 60, "min_online": 2 },
       { "name": "Porto Alegre", "failover_delay": 60, "min_online": 3 }
    ],
    "details": {
        "Riga": { "state": 3, "available": 10, "pavailable": 20 },
        "Tokyo": { "state": 3, "available": 10, "pavailable": 20 },
        "Porto Alegre": { "state": 1, "available": 0, "pavailable": 0 }
    }
}

zabbix[proxy_buffer,buffer,<mode>]

Статистика использования буфера памяти прокси.
Возвращаемые значения: Integer (для размера); Float (для процента).

Параметры:

• mode:
  • total - общий размер буфера (можно использовать для проверки, включен ли буфер памяти);
  • free - размер свободного буфера;
  • pfree - процент свободного буфера;
  • used - размер используемого буфера;
  • pused - процент используемого буфера.

Комментарии:

• Возвращает ошибку 'Proxy memory buffer is disabled', когда буфер памяти отключен;
• Этот элемент данных не поддерживается на сервере Zabbix.

zabbix[proxy_buffer,state,changes]

Возвращает количество изменений состояния между режимами буфера диск/память с момента запуска.
Возвращаемое значение: Целое число; 0 - буфер памяти отключён.

Комментарии:

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

zabbix[proxy_buffer,state,current]

Возвращает текущее рабочее состояние, в котором сохраняются новые данные.
Возвращаемые значения: 0 - диск; 1 - память.

Комментарии:

• 0 также возвращается, когда буфер памяти отключен.

zabbix[proxy_history]

Количество значений в таблице истории прокси, ожидающих отправку на сервер.
Возвращаемое значение: Целое число.

Комментарии:

• Этот элемент данных не поддерживается на сервере Zabbix.

zabbix[queue,<from>,<to>]

Количество контролируемых элементов данных в очереди, задержка которых составляет не менее <from> секунд, но менее <to> секунд.
Возвращаемое значение: Integer.

Параметры:

• from - задержка не менее (по умолчанию 6 секунд);
• to - задержка не более (по умолчанию бесконечность).

Комментарии:

• В параметрах поддерживаются суффиксы времени (s,m,h,d,w).

zabbix[rcache,<cache>,<mode>]

Статистика доступности кэша конфигурации Zabbix.
Возвращаемые значения: Integer (для размера); Float (для процента).

Параметры:

• cache - buffer;
• mode:
  • total - общий размер буфера;
  • free - размер свободного буфера;
  • pfree - процент свободного буфера;
  • used - размер используемого буфера;
  • pused - процент используемого буфера.

zabbix[requiredperformance]

Требуемая производительность сервера Zabbix или прокси Zabbix, в ожидаемом количестве новых значений в секунду.
Возвращаемое значение: Float.

Комментарии:

• Примерно соответствует пункту "Required server performance, new values per second" в Reports > System information.

zabbix[stats,<ip>,<port>]

Возвращает внутренние метрики сервера Zabbix или прокси. Если указаны <ip> и <port>, метрики извлекаются с удаленного экземпляра; в противном случае — с локального экземпляра.
Возвращаемые значения: JSON object.

Параметры:

• ip - список IP/DNS/сетевых масок серверов/прокси, к которым выполняется удаленный запрос (по умолчанию 127.0.0.1);
• port - порт сервера/прокси, к которому выполняется удаленный запрос (по умолчанию 10051).

Комментарии:

• Запрос stats будет принят только с адресов, перечисленных в параметре StatsAllowedIP server/proxy на целевом экземпляре.
• Этот элемент данных возвращает выбранный набор внутренних метрик. Подробности см. в разделе Удаленный мониторинг статистики Zabbix.

zabbix[stats,<ip>,<port>,queue,<from>,<to>]

Возвращает внутренние метрики очереди (см. zabbix[queue,<from>,<to>]) сервера или прокси Zabbix. Если указаны <ip> и <port>, метрики извлекаются из удаленного экземпляра; в противном случае — из локального экземпляра.
Возвращаемые значения: объект JSON.

Параметры:

• ip - список IP/DNS/масок сети серверов/прокси, к которым выполняется удаленный запрос (по умолчанию 127.0.0.1);
• port - порт сервера/прокси, к которому выполняется удаленный запрос (по умолчанию 10051);
• from - задержка не менее чем на (по умолчанию 6 секунд);
• to - задержка не более чем на (по умолчанию бесконечность).

Комментарии:

• Запрос stats будет принят только с адресов, перечисленных в параметре StatsAllowedIP сервер/прокси на целевом экземпляре.
• Этот элемент данных возвращает выбранный набор внутренних метрик. Подробности см. в разделе Удаленный мониторинг статистики Zabbix.

zabbix[tcache,cache,<parameter>]

Статистика эффективности кэша функции трендов Zabbix.
Возвращаемые значения: Integer (для размера); Float (для процента).

Параметры:

• parameter:
  • all - общее количество запросов к кэшу (по умолчанию);
  • hits - попадания в кэш;
  • phits - процент попаданий в кэш;
  • misses - промахи кэша;
  • pmisses - процент промахов кэша;
  • items - количество кэшированных элементов;
  • requests - количество кэшированных запросов;
  • pitems - процент кэшированных элементов от кэшированных элементов + запросов. Низкий процент, скорее всего, означает, что размер кэша можно уменьшить.

Комментарии:

• Этот элемент данных не поддерживается на прокси Zabbix.

zabbix[triggers]

Количество активированных триггеров в базе данных Zabbix, со всеми активированными элементами данных, которые упомянуты в выражениях триггеров на активированных узлах сети.
Возвращаемое значение: Целое число.

Комментарии:

• Этот элемент данных не поддерживается на Zabbix прокси.

zabbix[uptime]

Время непрерывной работы процесса Zabbix сервера или прокси в секундах.
Возвращаемое значение: Целое число.

zabbix[vcache,buffer,<mode>]

Статистика доступности кэша значений Zabbix.
Возвращаемые значения: Integer (для размера); Float (для процента).

Параметры:

• mode:
  • total - общий размер буфера;
  • free - размер свободного буфера;
  • pfree - процент свободного буфера;
  • used - размер используемого буфера;
  • pused - процент используемого буфера.

Комментарии:

• Этот элемент данных не поддерживается на прокси Zabbix.

zabbix[vcache,cache,<parameter>]

Статистика эффективности кэша значений Zabbix.
Возвращаемое значение: Integer. Если для <parameter> задано значение mode, возвращаемое значение: 0 - нормальный режим; 1 - режим низкой памяти.

Параметры:

• parameter:
  • requests - общее количество запросов;
  • hits - количество попаданий в кэш (исторические значения, взятые из кэша);
  • misses - количество промахов кэша (исторические значения, взятые из базы данных);
  • mode - режим работы кэша значений.

Комментарии:

• После включения режима низкой памяти кэш значений будет оставаться в этом состоянии в течение 24 часов, даже если проблема, вызвавшая этот режим, будет устранена раньше.
• Вы можете использовать этот ключ с шагом предварительной обработки Change per second, чтобы получать статистику значений в секунду.
• Этот элемент данных не поддерживается на прокси Zabbix.

zabbix[version]

Версия Zabbix сервера или прокси.
Возвращаемое значение: Строка. Например: 7.0.0.

zabbix[vmware,buffer,<mode>]

Статистика доступности кэша Zabbix vmware.
Возвращаемые значения: Integer (для размера); Float (для процента).

Параметры:

• mode:
  • total - общий размер буфера;
  • free - размер свободного буфера;
  • pfree - процент свободного буфера;
  • used - размер используемого буфера;
  • pused - процент используемого буфера.

zabbix[vps,written]

Общее количество значений истории, записанных в базу данных.
Возвращаемое значение: Целое число.

zabbix[wcache,<cache>,<mode>]

Статистика и доступность write cache Zabbix.
Возвращаемые значения: Integer (для количества/размера); Float (для процента).

Параметры:

• cache - values, history, index или trend;
• mode:
  • с параметром кэша values:
    • all - общее количество значений, обработанных сервером/прокси Zabbix, за исключением неподдерживаемых элементов данных (счетчик) (по умолчанию);
    • float - количество обработанных значений с плавающей точкой (счетчик);
    • uint - количество обработанных беззнаковых целых значений (счетчик);
    • str - количество обработанных символьных/строковых значений (счетчик);
    • log - количество обработанных лог-значений (счетчик);
    • text - количество обработанных текстовых значений (счетчик);
    • bin - количество обработанных двоичных значений (счетчик);
    • json - количество обработанных JSON-значений (счетчик);
    • not supported - количество случаев, когда обработка элемента данных приводила к тому, что элемент данных становился неподдерживаемым или оставался в этом состоянии (счетчик);
  • с параметрами кэша history, index, trend:
    • pfree - процент свободного буфера (по умолчанию);
    • total - общий размер буфера;
    • free - размер свободного буфера;
    • used - размер занятого буфера;
    • pused - процент занятого буфера.

Комментарии:

• Параметр кэша trend не поддерживается в Zabbix proxy.
• History cache используется для хранения значений элементов данных. Низкое значение указывает на проблемы с производительностью на стороне базы данных.
• History index cache используется для индексирования значений, хранящихся в history cache.
• После того как history cache заполнится и затем будет очищен, history index cache все равно будет хранить часть данных. Такое поведение ожидаемо и помогает системе работать эффективнее, избегая дополнительной обработки, необходимой для постоянного изменения размера памяти.
• Trend cache хранит агрегированные данные за текущий час для всех элементов данных, которые получают данные.
• Вы можете использовать ключ zabbix[wcache,values] со шагом предварительной обработки Change per second, чтобы получать статистику значений в секунду.