5 Внутренние механизмы Zabbix

Обзор

Внутренние проверки позволяют наблюдать за внутренними процессами Zabbix. Другими словами, вы можете наблюдать, что происходит с 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.4.0").

Параметры:

• param - ping или version.

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

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

zabbix[lld_queue]

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

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

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

zabbix[preprocessing]

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

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

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

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

{"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, 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, регистрируется как таковой и не меняет и не обновляет состояние, пока не станет idle. Это гарантирует, что даже полностью зависшие процессы будут корректно зарегистрированы как busy на 100%.
• В настоящее время "busy" означает "не спит", но в будущем могут быть введены дополнительные состояния - ожидание блокировок, выполнение запросов к базе данных и т. д. Обратите внимание, что асинхронные poller считаются busy, если они достигли лимита, заданного конфигурационным параметром MaxConcurrentChecksPerPoller сервер/прокси.
• В 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,<имя>,<параметр>]

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

Параметры:

• имя — имя прокси;
• параметр — lastaccess — штамп времени последнего сообщения о доступности от прокси;
  delay — длительность задержки отправки собранных значений, рассчитывается как «задержка прокси» + («текущее время сервера» - «последний доступ прокси»), где «задержка прокси» — это разница между текущим временем прокси и отметкой времени самого старого неотправленного значения на прокси.

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

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

Примеры:

zabbix[proxy,"Germany",lastaccess] #отметка времени последнего сообщения о доступности, полученного от прокси «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,<режим>]

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

Параметры:

• режим: 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,<от>,<до>]

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

Параметры:

• от — задерживаются минимум (по умолчанию: 6 секунд);
• до — задерживаются максимум (по умолчанию: бесконечно).

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

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

zabbix[rcache,<кэш>,<режим>]

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

Параметры:

• кэш — buffer;
• режим — total — полный размер буфера;
  free — размер свободного места в буфере;
  pfree — процент свободного места в буфере;
  used — размер использованного места в буфере;
  pused — процент использования буфера.

zabbix[requiredperformance]

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

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

• Приблизительно соответствует значению «Требуемое быстродействие сервера, новые значения в секунду (Required server performance, new values per second)» со страницы Отчёты → Информация о системе (Reports → System information).

zabbix[stats,<ip>,<порт>]

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

Параметры:

• ip — список IP/DNS/сетевой маски опрашиваемых удалённо серверов/прокси (по умолчанию 127.0.0.1);
• порт — порт опрашиваемого удалённо сервера/прокси (по умолчанию 10051).

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

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

zabbix[stats,<ip>,<порт>,queue,<от>,<до>]

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

Параметры:

• ip — список IP/DNS/сетевой маски опрашиваемых удалённо серверов/прокси (по умолчанию 127.0.0.1);
• порт — порт опрашиваемого удалённо сервера/прокси (по умолчанию 10051);
• от — с задержкой по крайней мере (по умолчанию от 6 секунд);
• до — с задержкой не более (по умолчанию до бесконечности).

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

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

zabbix[tcache,cache,<параметр>]

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

Параметры:

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

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

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

zabbix[triggers]

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

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

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

zabbix[uptime]

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

zabbix[vcache,buffer,<режим>]

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

Параметры:

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

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

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

zabbix[vcache,cache,<параметр>]

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

Параметры:

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

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

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

zabbix[version]

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

zabbix[vmware,buffer,<режим>]

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

Параметры:

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

zabbix[vps,written]

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

zabbix[wcache,<кэш>,<режим>]

Статистика и доступность кэша записи Zabbix.
Возвращаемое значение: Целое число (для количества/размера); Число с плавающей точкой (для процентов).

Параметры:

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

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

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