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

Обзор

Внутренние проверки позволяют наблюдать за внутренними процессами 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 (например: "8.0.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), такой элемент данных перейдет в состояние unsupported.
• Минимум и максимум относятся к проценту использования для одного процесса. Поэтому если в группе из 3 poller проценты использования по процессам были 2, 18 и 66, min вернет 2, а max вернет 66.
• Процессы сообщают о том, что они делают, в общей памяти, а процесс self-monitoring каждую секунду суммирует эти данные. Изменения состояния (busy/idle) регистрируются в момент изменения - таким образом, процесс, который становится busy, регистрируется как таковой и не меняет и не обновляет состояние, пока не станет idle. Это гарантирует, что даже полностью зависшие процессы будут корректно зарегистрированы как busy на 100%.
• В настоящее время "busy" означает "не спит", но в будущем могут быть введены дополнительные состояния - ожидание блокировок, выполнение запросов к базе данных и т. д. Обратите внимание, что асинхронные 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 - как долго собранные значения остаются неотправленными; вычисляется как "задержка прокси" + ("текущее время сервера" - "последний доступ прокси"), где "задержка прокси" - это разница между текущим временем прокси и временной меткой самого старого неотправленного значения на прокси.

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

• Этот элемент данных всегда обрабатывается сервером 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,<режим>]

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

Параметры:

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

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

Параметры:

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

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

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

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

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

Параметры:

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

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

• Запрос stats будет принят только с адресов, перечисленных в параметре 'StatsAllowedIP' server/proxy на целевом экземпляре.
• Элемент данных возвращает выбранный набор внутренних метрик. Подробности см. в разделе Удаленный мониторинг статистики 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. Например: 8.0.0.

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

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

Параметры:

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

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

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