8. Внутренние проверки

Обзор

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

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

• на стороне Zabbix сервера — если узел сети наблюдается через сервер
• на стороне Zabbix прокси — если узел сети наблюдается через прокси

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

Для использования этого элемента данных выберите тип элемента данных Внутренний Zabbix.

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

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

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

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

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

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

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

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

zabbix[boottime]

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

zabbix[cluster,discovery,nodes]

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

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

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

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,,<параметр>]

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

Параметры:

• параметр — ping или version.

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

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

zabbix[lld_queue]

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

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

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

zabbix[preprocessing_queue]

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

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

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

zabbix[process,<тип>,<режим>,<состояние>]

Время конкретного процесса Zabbix или группы процессов (указываются с помощью <тип> и <режим>), потраченное на <состояние> в процентах. Расчёт производится только за последнюю минуту. Параметр <тип> является обязательным.
Возвращаемое значение: Число с плавающей точкой.

Параметры:

• тип — для процессов сервера: agent poller, alert manager, alert syncer, alerter, availability manager, configuration syncer, configuration syncer worker, connector manager, connector worker, discovery manager, discovery worker, escalator, ha manager (с Zabbix 7.0.5), history poller, history syncer, housekeeper, http agent poller, http poller, icmp pinger, 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, configuration syncer, data sender, discovery manager, discovery worker, history syncer, housekeeper, http agent poller, http poller, icmp pinger, 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;
• режим — avg — среднее значение по всем процессам указанного типа (по умолчанию);
  count — количество экземпляров указанного типа процесса, <состояние> не должно быть указано;
  max — максимальное значение;
  min — минимальное значение;
  <номер процесса> — номер процесса (от 1 до количества экземпляров процессов; например, если запущенно 4 траппера, тогда значение от 1 до 4);
• состояние — busy — процесс в занятом состоянии, например, обработка запроса (по умолчанию);
  idle — процесс в состоянии простоя, ничего не делающий.

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

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

Примеры:

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

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]

Возвращает список групп прокси с данными конфигурации и данными в реальном времени. Данные конфигурации включают имя группы прокси, задержку переключения и минимально необходимое количество онлайн-прокси. Данные в реальном времени включают состояние группы прокси (смотрите подробности в комментариях), количество онлайн-прокси и процент онлайн-прокси.
Возвращаемое значение: Объект 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 сервера или прокси, ожидаемых новых значений в секунду.
Возвращаемое значение: Число с плавающей точкой.

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

• Приблизительно соответствует значению «Требуемое быстродействие сервера, новые значения в секунду» со страницы Отчёты → Информация о системе.

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

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

Параметры:

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

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

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

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

Метрики внутренней очереди удалённого Zabbix сервера или прокси (смотрите zabbix[queue,<от>,<до>]).
Возвращаемое значение: Объект JSON.

Параметры:

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

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

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

zabbix[tcache,<кэш>,<параметр>]

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

Параметры:

• кэш — buffer;
• параметр — 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 сервера или прокси.
Возвращаемое значение: Строка. Например: 7.0.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 — количество обработанных текстовых значений (счётчик);
  not supported — количество раз, когда обработка элементов данных приводила к тому, что элемент данных становился неподдерживаемым или сохранял это состояние (счётчик);
  (для параметра кэша history, index, trend) pfree (по умолчанию) — свободное место в буфере в процентах;
  total — полный размер буфера;
  free — размер свободного места в буфере;
  used — размер занятого места в буфере;
  pused — занятое место в буфере в процентах.

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

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