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

Обзор

Внутренние проверки позволяют отслеживать внутренние процессы 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]

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

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

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

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

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

zabbix[boottime]

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

zabbix[cluster,discovery,nodes]

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

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

• Этот элемент данных можно использовать в низкоуровневом обнаружении.
• Возвращаемые поля в основном соответствуют свойствам объекта узла высокой доступности.
• Дополнительные поля:
  • db_timestamp — текущее время сервера (временная метка Unix), включённое в ответ
  • lastaccess_age — количество секунд с момента последнего heartbeat узла (db_timestamp - lastaccess)
  • status — состояние узла:
    • 0 — резервный
    • 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,<type>,available]

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

Параметры:

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

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

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

Пример:

zabbix[proxy,"Germany",lastaccess] #the timestamp of the last heartbeat message received from "Germany" proxy

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,<from>,<to>]

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

Параметры:

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

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

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

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

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

Параметры:

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

zabbix[requiredperformance]

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

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

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

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

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

Параметры:

• 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 object.

Параметры:

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

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

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

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

Параметры:

• режим — 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.
Возвращаемое значение: String. Например: 8.0.0.

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

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

Параметры:

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

zabbix[vps,written]

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

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

Статистика и доступность кэша записи 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.
• Кэш history используется для хранения значений элементов данных. Низкое значение указывает на проблемы с производительностью на стороне базы данных.
• Кэш индекса history используется для индексации значений, хранящихся в кэше history.
• После заполнения и последующей очистки кэша history кэш индекса history всё равно будет хранить некоторые данные. Такое поведение является ожидаемым и помогает системе работать эффективнее, избегая дополнительной обработки, необходимой для постоянного изменения размера памяти.
• Кэш trend хранит агрегированные данные за текущий час для всех элементов данных, получающих данные.
• Вы можете использовать ключ zabbix[wcache,values] с шагом предобработки Change per second, чтобы получить статистику значений в секунду.