Zabbix Documentation 4.2

2.23.04.04.2 (current)In development:4.4 (devel)Unsupported:1.82.02.43.23.4

User Tools

Site Tools

This translation is older than the original page and might be outdated. See what has changed.

Sidebar

ru:manual:config:items:itemtypes:zabbix_agent

This is an old revision of the document!


1 Zabbix агент

Обзор

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

Существуют пассивные и активные проверки. При настройке элемента данных, вы можете выбрать требуемый тип:

  • Zabbix агент - для пассивных проверок
  • Zabbix агент (активный) - для активных проверок

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

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

Смотрите также:

Обязательные и необязательные параметры

Параметры без угловых скобок обязательны. Параметры, отмеченные угловыми скобками < >, необязательны.

Ключ
Описание Возвращаемое значение Параметры Комментарии
agent.hostname
Имя хоста агента. Строка Возвращает действительное значение hostname агента из файла конфигурации.
agent.ping
Проверка доступности агента. Ничего - недоступен

1 - доступен
Используйте nodata() функцию триггера для проверки недоступности узла сети.
agent.version
Версия Zabbix агента. Строка Пример возвращаемого значения: 1.8.2
kernel.maxfiles
Максимальное количество открытых файлов поддерживаемое ОС. Целое число
kernel.maxproc
Максимальное количество процессов поддерживаемое ОС. Целое число
log[файл,<регулярное выражение>,<кодировка>,<макс. кол-во строк>,<режим>,<вывод>]
Мониторинг файлов журналов (логов). Журнал (лог) файл - абсолютный путь и имя файла журнала
регулярное выражение - регулярное выражение описывающее требуемый шаблон содержимого
кодировка - идентификатор кодовой страницы
макс. кол-во строк - максимальное количество новых строк в секунду, которое агент будет отправлять Zabbix серверу или прокси. Этот параметр заменяет значение 'MaxLinesPerSecond' в zabbix_agentd.conf
режим - возможные значения:
all (по умолчанию), skip - пропуск обработки старых данных (влияет только на недавно созданные элементы данных, которые еще не получали никаких данных). вывод - дополнительный шаблон форматирования вывода.
\0 - управляющая последовательность заменяется найденным текстом, тогда
\N (где N=1..9) - управляющая последовательность заменяется N-нной совпадающей группой (или пустой строкой, если N превышает количество найденных групп).
Элемент данных должен быть настроен активной проверкой.
Если файл не существует или доступ к нему не разрешен, элемент данных переходит в состояние неподдерживается.

Если параметр вывод оставить пустым - будет возвращена вся строка соответствующая регулярному выражению.
Заметьте, что все глобальные регулярные выражения исключая 'Результат ИСТИНА' всегда возвращают всю строку соответствующую выражению и параметр вывод игнорируется.

Извлечение содержания согласно параметра вывод производится на стороне агенте.

Примеры:
⇒ log[/var/log/syslog]
⇒ log[/var/log/syslog,error]
⇒ log[/home/zabbix/logs/logfile,,,100]

Параметр вывод поддерживается начиная с Zabbix 2.2.
Параметр режим поддерживается начиная с Zabbix 2.0.

Смотрите дополнительную информацию о мониторинге файлов журналов.
logrt[файл_regexp,<регулярное выражение>,<кодировка>,<макс. кол-вл строк>,<журнал>,<вывод>]
Мониторинг файлов журналов (логов) с поддержкой ротации логов. Журнал (лог) файл_regexp - абсолютный путь к файлу и регулярное выражение описывающее его имя
регулярное выражение - регулярное выражение описывающее требуемый шаблон содержимого
кодировка - идентификатор кодовой страницы
макс. кол-во строк - максимальное количество новых строк в секунду, которое агент будет отправлять Zabbix серверу или прокси. Этот параметр заменяет значение 'MaxLinesPerSecond' в zabbix_agentd.conf
режим - возможные значения:
all (по умолчанию), skip - пропуск обработки старых данных (влияет только на недавно созданные элементы данных, которые еще не получали никаких данных).
вывод - дополнительный шаблон форматирования вывода:
\0 - управляющая последовательность заменяется найденным текстом, тогда
\N (где N=1..9) - управляющая последовательность заменяется N-нной совпадающей группой (или пустой строкой, если N превышает количество найденных групп).
Элемент данных должен быть настроен активной проверкой.
Ротация журналов основывается на времени последнего изменения файлов.

Если параметр вывод оставить пустым - будет возвращена вся строка соответствующая регулярному выражению.
Заметьте, что все глобальные регулярные выражения исключая 'Результат ИСТИНА' всегда возвращают всю строку соответствующую выражению и параметр вывод игнорируется.

Извлечение содержимого согласно параметра вывод производится на стороне агенте.

Примеры:
⇒ logrt["/home/zabbix/logs/^logfile[0-9]{1,3}$",,,100] → совпадает с файлом наподобии “logfile1” (но не совпадает с “.logfile1”)
⇒ logrt["/home/user/logfile_.*_[0-9]{1,3}","pattern_to_match","UTF-8",100] → будет собирать данные с файлов таких как "logfile_abc_1" или "logfile__001".

Параметр вывод поддерживается начиная с Zabbix 2.2
Параметр режим поддерживается начиная с Zabbix 2.0

Смотрите дополнительную информацию о мониторинге файлов журналов.
net.dns[<ip>,зона,<тип>,<время ожидания>,<количество>,<протокол>]
Проверка, работает ли DNS сервис. 0 - DNS не работает (сервер не ответил или ответ DNS некорректен)

1 - DNS работает
ip - IP адрес DNS сервера (оставьте пустым, чтобы использовать DNS сервера по умолчанию, игнорируется в Windows)
зона - тестируемая зона DNS
тип - запрашиваемый тип записи (по умолчанию SOA)
время ожидания (игнорируется в Windows) - время ожидания ответа в секундах (по умолчанию 1 секунда)
количество (игнорируется в Windows) - количество попыток запросов (по умолчанию 2)
протокол - используемый протокол при выполнении DNS запросов: udp (по умолчанию) или tcp
Пример ключа:
⇒ net.dns[8.8.8.8,zabbix.com,MX,2,1]

Возможные значения для тип:
ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (исключая Windows), HINFO, MINFO, TXT, SRV

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

Параметр протокол поддерживается начиная с Zabbix 3.0.
Тип записи SRV поддерживается Zabbix агентом начиная с версий 1.8.6 (Unix) и 2.0.0 (Windows).

Название до Zabbix 2.0 (еще поддерживается): net.tcp.dns
net.dns.record[<ip>,зона,<тип>,<время ожидания>,<количество>,<протокол>]
Выполнение DNS запроса. Строка символов с требуемым типом информации ip - IP адрес DNS сервера (оставьте пустым, чтобы использовать DNS сервера по умолчанию, игнорируется в Windows)
зона - тестируемая зона DNS
тип - запрашиваемый тип записи (по умолчанию SOA)
время ожидания (игнорируется в Windows) - время ожидания ответа в секундах (по умолчанию 1 секунда)
количество (игнорируется в Windows) - количество попыток запросов (по умолчанию 2)
протокол - используемый протокол при выполнении DNS запросов: udp (по умолчанию) или tcp
Пример ключа:
⇒ net.dns.record[8.8.8.8,zabbix.com,MX,2,1]

Возможные значения для тип:
ANY, A, NS, CNAME, MB, MG, MR, PTR, MD, MF, MX, SOA, NULL, WKS (исключая Windows), HINFO, MINFO, TXT, SRV

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

Параметр протокол поддерживается начиная с Zabbix 3.0.
Тип записи SRV поддерживается в Zabbix агенте начиная с версий 1.8.6 (Unix) и 2.0.0 (Windows).

Название до Zabbix 2.0 (еще поддерживается): net.tcp.dns.query
net.if.collisions[if]
Коллизии за пределами окна (out-of-window). Целое число if - имя сетевого интерфейса
net.if.discovery
Список сетевых интерфейсов. Используется низкоуровневым обнаружением. Объект JSON Поддерживается Zabbix агентом начиная с версии 2.0.

На FreeBSD, OpenBSD и NetBSD поддерживается начиная с версии Zabbix агента 2.2

В некоторых версиях Windows (например, Server 2008) может потребоваться установка последних обновлений для поддержки не-ASCII символов в именах интерфейсов.
net.if.in[if,<режим>]
Статистика по входящему трафику сетевого интерфейса. Целое число if - имя сетевого интерфейса (Unix); полное описание сетевого интерфейса или IPv4 адрес (Windows)
режим - возможные значения:
bytes - количество байт (по умолчанию)
packets - количество пакетов
errors - количество ошибок
dropped - количество отброшенных пакетов
В Windows элемент данных берет значения с 64-битный счетчиков, если они доступны. 64-битные счетчики статистики по интерфейсам введены в Windows Vista и Windows Server 2008. Если 64-битный счетчики недоступны, агент будет использовать 32-битные счетчики.

Начиная с Zabbix агента 1.8.6 на Windows поддерживаются мультибайтные имена интерфейса.

Примеры:
⇒ net.if.in[eth0,errors]
⇒ net.if.in[eth0]

Вы можете получить описания сетевых интерфейсов в Windows, используя элементы данных net.if.discovery или net.if.list.

Вы можете использовать этот ключ с параметром хранения значений Дельта (скорость в секунду) для получения статистики байт в секунду.
net.if.out[if,<режим>]
Статистика по исходящему трафику сетевого интерфейса. Целое число if - имя сетевого интерфейса (Unix); полное описание сетевого интерфейса или IPv4 адрес (Windows)
режим - возможные значения:
bytes - количество байт (по умолчанию)
packets - количество пакетов
errors - количество ошибок
dropped - количество отброшенных пакетов
В Windows элемент данных берет значения с 64-битный счетчиков, если они доступны. 64-битные счетчики статистики по интерфейсам введены в Windows Vista и Windows Server 2008. Если 64-битный счетчики недоступны, агент будет использовать 32-битные счетчики.

Начиная с Zabbix агента 1.8.6 на Windows поддерживаются мультибайтные имена интерфейса.

Примеры:
⇒ net.if.out[eth0,errors]
⇒ net.if.out[eth0]

Вы можете получить описания сетевых интерфейсов в Windows, используя элементы данных net.if.discovery или net.if.list.

Вы можете использовать этот ключ с параметром хранения значений Дельта (скорость в секунду) для получения статистики байт в секунду.
net.if.total[if,<режим>]
Суммарная статистика входящего и исходящего трафика на сетевом интерфейсе. Целое число if - имя сетевого интерфейса (Unix); полное описание сетевого интерфейса или IPv4 адрес (Windows)
режим - возможные значения:
bytes - количество байт (по умолчанию)
packets - количество пакетов
errors - количество ошибок
dropped - количество отброшенных пакетов
В Windows элемент данных берет значения с 64-битный счетчиков, если они доступны. 64-битные счетчики статистики по интерфейсам введены в Windows Vista и Windows Server 2008. Если 64-битный счетчики недоступны, агент будет использовать 32-битные счетчики.

Примеры:
⇒ net.if.total[eth0,errors]
⇒ net.if.total[eth0]

Вы можете получить описания сетевых интерфейсов в Windows, используя элементы данных net.if.discovery или net.if.list.

Вы можете использовать этот ключ с параметром хранения значений Дельта (скорость в секунду) для получения статистики байт в секунду.

Обратите внимание, отброшенные пакеты поддерживаются только, если оба ключа net.if.in и net.if.out работают с отброшенными пакетами на вашей платформе.
net.tcp.listen[порт]
Проверка, находится ли TCP порт в состоянии LISTEN. 0 - не находится в состоянии LISTEN

1 - находится в состоянии LISTEN
порт - номер TCP порта Пример:
⇒ net.tcp.listen[80]

В Linux поддерживается Zabbix агентом начиная с версии 1.8.4

Начиная с Zabbix 3.0.0, в ядрах Linux 2.6.14 и более новых, информация о TCP сокетах в состоянии listen берется из интерфейса ядра NETLINK, если возможно. В противном случае, информация берется из файлов /proc/net/tcp и /proc/net/tcp6.
net.tcp.port[<ip>,порт]
Проверка возможности создания TCP подключения на указанный номер порта. 0 - не удалось подключиться

1 - удалось подключиться
ip - IP адрес (по умолчанию 127.0.0.1)
порт - номер порта
Пример:
⇒ net.tcp.port[,80] → можно использовать для проверки доступности веб-сервера, работающего на 80 порту.

Для простого тестирования производительности TCP используйте net.tcp.service.perf[tcp,<ip>,<порт>]

Обратите внимание, что эти проверки могут привести к дополнительным записям в системных файлах журналов (обычно сессии SMTP и SSH журналируются).

Старое название: check_port[*]
net.tcp.service[сервис,<ip>,<порт>]
Проверка, запущен ли сервис и принимает ли он TCP подключения. 0 - сервис недоступен

1 - сервис запущен
сервис - один из:
ssh, ntp, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https, telnet(смотри детали)
ip - IP адрес (по умолчанию 127.0.0.1)
порт - номер порта (по умолчанию используется стандартный номер порта сервиса)
Пример:
⇒ net.tcp.service[ftp,,45] - можно использовать для тестирования доступности FTP сервера на TCP 45 порту.

Обратите внимание, что эти проверки могут привести к дополнительным записям в системных файлах журналов (обычно сессии SMTP и SSH журналируются).

Проверка шифрованных протоколов (таких как IMAP на 993 порту или POP на 995 порту) в настоящее время не поддерживается. Как решение, пожалуйста, для подобных проверок используйте net.tcp.port.

Проверка LDAP и HTTPS через Windows агента в настоящее время не поддерживается.

Обратите внимание, что telnet проверка ищет запрос на вход (с ':' в конце).

Смотрите также известные проблемы по проверке HTTPS сервиса.

Сервисы https и telnet поддерживается Zabbix с версии 2.0.

Старое название: check_service[*]
net.tcp.service.perf[сервис,<ip>,<порт>]
Проверка производительности TCP сервиса. 0 - сервис недоступен

секунды - количество секунд потраченное на подключение к сервису
сервис - один из:
ssh, ntp, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https, telnet (смотри детали)
ip - IP адрес (по умолчанию 127.0.0.1)
порт - номер порта (по умолчанию используется стандартный номер порта сервиса)
Пример:
⇒ net.tcp.service.perf[ssh] - можно использовать для тестирования скорости изначального ответа от SSH сервера.

Проверка шифрованных протоколов (таких как IMAP на 993 порту или POP на 995 порту) в настоящее время не поддерживается. Как решение, пожалуйста, для подобных проверок используйте net.tcp.service.perf[tcp,<ip>,<порт>].

Проверка LDAP и HTTPS через Windows агента в настоящее время не поддерживается.

Обратите внимание, что telnet проверка ищет запрос на вход (с ':' в конце).

Смотрите также известные проблемы по проверке HTTPS сервиса.

Сервисы https и telnet поддерживается Zabbix с версии 2.0.

Старое название: check_service_perf[*]
net.udp.listen[порт]
Проверка, находится ли UDP порт в состоянии LISTEN. 0 - не находится в состоянии LISTEN

1 - находится в состоянии LISTEN
порт - номер UDP порта Например:
⇒ net.udp.listen[68]

В Linux поддерживается Zabbix агентом начиная с версии 1.8.4
net.udp.service[сервис,<ip>,<порт>]
Проверка, запущен ли сервис и принимает ли он TCP подключения. 0 - сервис недоступен

1 - сервис запущен
сервис - ntp (смотри детали)
ip - IP адрес (по умолчанию 127.0.0.1)
порт - номер порта (по умолчанию используется стандартный номер порта сервиса)
Пример:
⇒ net.udp.service[ntp,,45] → можно использовать для тестирования доступности NTP сервиса на 45 порту UDP.

Этот элемент данных поддерживается начиная с Zabbix 3.0, но ntp сервис был доступен в net.tcp.service[] элементе данных и в предыдущих версиях.
net.udp.service.perf[сервис,<ip>,<порт>]
Проверка производительности UDP сервиса. 0 - сервис недоступен

секунды - количество секунд потраченное на подключение к сервису
сервис - ntp (смотри детали)
ip - IP адрес (по умолчанию 127.0.0.1)
порт - номер порта (по умолчанию используется стандартный номер порта сервиса)
Пример:
⇒ net.udp.service.perf[ntp] → можно использовать для тестирования времени ответа от NTP сервиса.

Этот элемент данных поддерживается начиная с Zabbix 3.0, но ntp сервис был доступен в net.tcp.service[] элементе данных и в предыдущих версиях.
proc.cpu.util[<имя>,<пользователь>,<тип>,<cmdline>,<режим>,<зона>]
Использование CPU процесса в процентах. Число с плавающей точкой имя - имя процесса (по умолчанию все процессы)
пользователь - имя пользователя (по умолчанию все пользователи)
тип - тип использования CPU:
total (по умолчанию), user, system
cmdline - фильтр по командной строке (является регулярным выражением)
режим - режим сбора данных: avg1 (по умолчанию), avg5, avg15
зона - целевая зона: current (по умолчанию), all. Этот параметр поддерживается только на Solaris платформе.
Примеры:
⇒ proc.cpu.util[,root] → Использование CPU по всем процессам работающими под “root” пользователем
⇒ proc.cpu.util[zabbix_server,zabbix] → Использование CPU по всем процессам zabbix_server работающими под пользователем zabbix

Возвращаемое значение основывается на использовании одного ядра CPU, в процентах. Например, утилизация CPU процесса полного использования двух ядер равна 200%.

Данные использования CPU собираются коллекторами, которые поддерживают максимально до 1024 уникальных (по имени, пользователю и командной строке) запросов. Запросы, к которым не было обращения в течении последних 24 часов, удаляются из коллектора.

Этот ключ поддерживается начиная с Zabbix 3.0.0 и также доступен на нескольких платформах (смотри Поддерживаемые элементы данных по платформам).
proc.mem[<имя>,<пользователь>,<режим>,<cmdline>]
Количество памяти используемое процессом в байтах. Целое число имя - имя процесса (по умолчанию все процессы)
пользователь - имя пользователя (по умолчанию все пользователи)
режим - возможные значения:
avg, max, min, sum (по умолчанию)
cmdline - фильтр по командной строке (является регулярным выражением)
Примеры:
⇒ proc.mem[,root] - память используемая всеми процессами запущенными под пользователем “root”
⇒ proc.mem[zabbix_server,zabbix] - память используемая всеми процессами zabbix_server запущенными под пользователем zabbix
⇒ proc.mem[,oracle,max,oracleZABBIX] - максимальное значение используемой памяти процессами запущенными под пользователем oracle и имеющими oracleZABBIX в содержимом командной строки
proc.num[<имя>,<пользователь>,<состояние>,<cmdline>]
Количество процессов. Целое число имя - имя процесса (по умолчанию “все процессы”)
пользователь - имя пользователя (по умолчанию “все пользователи”)
состояние - возможные значения: all (по умолчанию), run, sleep, zomb
cmdline - фильтр по командной строке (является регулярным выражением)
Примеры ключей:
⇒ proc.num[,mysql] - количество процессов выполняемых под пользователем mysql
⇒ proc.num[apache2,www-data] - количество процессов apache2 выполняемых под пользователем www-data
⇒ proc.num[,oracle,sleep,oracleZABBIX] - количество процессов в спящем состоянии выполняемых под oracle и имеющих oracleZABBIX в содержимом командной строки
В Windows, поддерживаются только параметры имя и пользователь.
sensor[устройство,сенсор,<режим>]
Чтение аппаратного сенсора. Число с плавающей точкой устройство - имя устройства
сенсор - имя сенсора
режим - возможные значения:
avg, max, min (если этот параметр не указан, то устройство и сенсор обрабатываются дословно).
В Linux 2.4, читается /proc/sys/dev/sensors.
Пример:
⇒ sensor[w83781d-i2c-0-2d,temp1]
До Zabbix 1.8.4, использовался формат sensor[temp1].
В Linux 2.6+, читается /sys/class/hwmon.
\\Более подробное описание смотрите у элемента данных сенсора в Linux.
В OpenBSD, читается MIB hw.sensors.
Примеры:
⇒ sensor[cpu0,temp0] - температура одного CPU
⇒ sensor[cpu[0-2]$,temp,avg] - средняя температура первых трех CPU
Поддерживается в OpenBSD Zabbix агентом начиная с версии 1.8.4.
system.boottime
Штамп времени (timestamp) загрузки системы. Целое число (UNIX timestamp)
system.cpu.discovery
Список найденных CPU/CPU ядер. Используется низкоуровневым обнаружением. Объект JSON Поддерживается на всех платформах с 2.4.0.
system.cpu.intr
Прерывания устройств. Целое число
system.cpu.load[<cpu>,<режим>]
Загрузка CPU. Число с плавающей точкой cpu - возможные значения:
all (по умолчанию), percpu (общая загрузка делится на количество CPU онлайн)
режим - возможные значения:
avg1 (усреднение за одну минуту, по умолчанию), avg5 (усреднение за 5 минут), avg15 (усреднение за 15 минут)
Пример:
⇒ system.cpu.load[,avg5]

Параметр percpu поддерживается начиная с Zabbix 2.0.0.

Старое название: system.cpu.loadX
system.cpu.num[<тип>]
Количество CPU. Целое число тип - возможные значения:
online (по умолчанию), max
Пример:
⇒ system.cpu.num
system.cpu.switches
Количество переключений контекста. Целое число Старое название: system[switches]
system.cpu.util[<cpu>,<тип>,<режим>]
Утилизация CPU в процентах. Число с плавающей точкой cpu - номер CPU (по умолчанию все CPU)
тип - возможные значения:
idle, nice, user (по умолчанию), system (по умолчанию для Windows), iowait, interrupt, softirq, steal, guest (на ядре Linux 2.6.24 и выше), guest_nice (на ядре Linux 2.6.33 и выше)
режим - возможные значения:
avg1 (усреднение за одну минуту, по умолчанию), avg5, avg15
Пример:
⇒ system.cpu.util[0,user,avg5]

Старое название: system.cpu.idleX, system.cpu.niceX, system.cpu.systemX, system.cpu.userX
system.hostname[<тип>]
Системное имя хоста. Строка тип (только для Windows, не должен использоваться на остальных системах) - возможные значения: netbios (по умолчанию) или host Получение значения либо функцией GetComputerName() (для netbios), либо функцией gethostname() (для host) в Windows и с помощью команды “hostname” на других системах.

Примеры возвращаемых значений:
в Linux:
⇒ system.hostname → linux-w7x1
⇒ system.hostname → www.zabbix.com
в Windows:
⇒ system.hostname → WIN-SERV2008-I6
⇒ system.hostname[host] → Win-Serv2008-I6LonG

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

Смотрите также более детальную информацию.
system.hw.chassis[<информация>]
Информация о шасси. Строка информация - возможные значения: full (по умолчанию), model, serial, type или vendor Пример:
⇒ system.hw.chassis[full] → Hewlett-Packard HP Pro 3010 Small Form Factor PC CZXXXXXXXX Desktop]

Этот ключ зависит от наличия SMBIOS таблицы в памяти.

Требуются Права root, потому что значение читается из памяти.

Поддерживается Zabbix агентом начиная с версии 2.0.
system.hw.cpu[<cpu>,<информация>]
Информация о CPU. Строка или целое чисо cpu - номер CPU или all (по умолчанию)
информация - возможные значения: full (по умолчанию), curfreq, maxfreq, model или vendor
Пример:
⇒ system.hw.cpu[0,vendor] → AuthenticAMD

Информация собирается из /proc/cpuinfo и из /sys/devices/system/cpu/[cpunum]/cpufreq/cpuinfo_max_freq.

Если указаны номер CPU и curfreq или maxfreq, то возвращается числовое значение (Гц).

Поддерживается Zabbix агентом начиная с версии 2.0.
system.hw.devices[<тип>]
Список PCI или USB устройств. Текст тип - pci (по умолчанию) или usb Пример:
⇒ system.hw.devices[pci] → 00:00.0 Host bridge: Advanced Micro Devices [AMD] RS780 Host Bridge
[..]

Возвращает вывод утилит lspci или lsusb (выполняются без каких либо параметров)

Поддерживается Zabbix агентом начиная с версии 2.0.
system.hw.macaddr[<интерфейс>,<формат>]
Список MAC адресов. Строка интерфейс - all (по умолчанию) или регулярное выражение
формат - full (по умолчанию) или short
Список MAC адресов чьи имена интерфейсов совпадают с заданным в интерфейс регулярным выражением (all список всех интерфейсов).

Пример: ⇒ system.hw.macaddr["eth0$",full] ⇒ [eth0] 00:11:22:33:44:55

Если формат задан как short, имена интерфейсов и одинаковые MAC адреса не попадают в список.

Поддерживается Zabbix агентом начиная с версии 2.0.
system.localtime[<тип>]
Системное время. Целое число - с тип как utc

Строка - с тип как local.
utc - (по умолчанию) время с начала Эпохи (00:00:00 UTC, Январь 1, 1970), измеренное в секундах.
local - время в формате 'гггг-мм-дд,чч:мм:сс.ннн,+чч:мм'
Параметры для этого элемента данных поддерживаются начиная с версии 2.0.
system.run[команда,<режим>]
Выполнение указанной команды на узле сети. Текст с результатом выполнения команды

1 - в режимеnowait (независимо от результата выполнения команды)
команда - выполняемая команда
режим - один из wait (по умолчанию, ожидать завершения выполнения), nowait (не ожидать)
Возвращается до 512КБ (64КБ до Zabbix 2.0.5), включая пробелы в конце, которые отрезаются.
Для корректной обработки, возвращаемые данные должны быть текстом.

Пример:
⇒ system.run[ls -l /] → подробный список файлов в папке root.

Обратите внимание: Для того чтобы включить этот функционал, в файле конфигурации агента должна быть указана опция EnableRemoteCommands=1.
Обратите внимание: Возвращаемое значение элемента данных является стандартным выводом совместно со стандартным выводом ошибок, которые получены от команды.
Обратите внимание: Пустой результат разрешается начиная с 2.4.0.

Смотрите также: Выполнение команд.
system.stat[источник,<тип>]
Статистика системы. Целое число или число с плавающей точкой ent - количество процессорных единиц выделенных на ресурс (с плавающей точкой)
kthr,<тип> - информация о состояниях потоков ядра:
r - среднее количество запускаемых потоков ядра (дробное)
b - среднее количество потоков ядра помещенных в очередь ожидания Менеджера Виртуальный Памяти (с плавающей точкой)
memory,<тип> - информация о использовании виртуальной и реальной памяти:
avm - активные виртуальные страницы (целое)
fre - размер свободного списка (целое)
page,<тип> - информация об ошибках страниц и активности страниц:
fi - операции страничного ввода файлов в секунду (с плавающей точкой)
fo - операции страничного вывода файлов в секунду (с плавающей точкой)
pi - pages paged in from paging space (с плавающей точкой)
po - pages paged out to paging space (с плавающей точкой)
fr - pages freed (page replacement) (с плавающей точкой)
sr - количество сканированных страниц алгоритмом замещения страниц (с плавающей точкой)
faults,<тип> - соотношение ловушек и прерываний:
in - прерывания устройства (с плавающей точкой)
sy - системные вызовы (с плавающей точкой)
cs - переключения контекста потока ядра (с плавающей точкой)
cpu,<тип> - раздельное использование процессорного времени в процентах:
us - пользовательское время (с плавающей точкой)
sy - системное время (с плавающей точкой)
id - время простоя (с плавающей точкой)
wa - время простоя в ходе которого система обрабатывала запросы I/O диска/NFS (с плавающей точкой)
pc - количество использованных физических процессоров (с плавающей точкой)
ec - процентное соотношение размеченного занятого пространства (с плавающей точкой)
lbusy - показывает утилизация в процентах для логических процессор(ов), которая произошла при выполнении уровней пользователя и системы (с плавающей точкой)
app - отображает количество доступных физических процессоров в распределенном пуле (с плавающей точкой)
disk,<тип> - статистика о дисках:
bps - отображает суммарное количество данных переданных (чтением или записью) на диск в байтах в секунду (целое)
tps - показывает количество передач за секунду, которые произошли на физическом диске/ленте (с плавающей точкой)
Этот элемент данных поддерживается начиная с версии 1.8.1.
system.sw.arch
Информация о архитектуре программного обеспечения. Строка Пример:
⇒ system.sw.arch → i686

Для получения информации используется функция uname().

Поддерживается Zabbix агентом начиная с версии 2.0.
system.sw.os[<информация>]
Информация об операционной системе. Строка информация - возможные значения: full (по умолчанию), short или name Пример:
⇒ system.sw.os[short] → Ubuntu 2.6.35-28.50-generic 2.6.35.11

Информация получается с (обратите внимание, на то что не все файлы представлены во всех дистрибутивах):
/proc/version (full)
/proc/version_signature (short)
/etc/issue.net (name)

Поддерживается Zabbix агентом начиная с версии 2.0.
system.sw.packages[<пакет>,<менеджер>,<формат>]
Список установленных пакетов. Текст пакет - all (по умолчанию) или регулярное выражение
менеджер - all (по умолчанию) или конкретный менеджер пакетов
формат - full (по умолчанию) или short
Список (в алфавитном порядке) установленных пакетов имена которых совпадают с регулярным выражением заданным в пакет (all списки всех).

Пример:
⇒ system.sw.packages[mini,dpkg,short]
→ python-minimal, python2.6-minimal, ubuntu-minimal

Поддерживаемые менеджеры пакетов (выполняемые команды):
dpkg (dpkg --get-selections)
pkgtool (ls /var/log/packages)
rpm (rpm -qa)
pacman (pacman -Q)

Если указан формат равный full, пакеты группируются по менеджерам пакетов (каждый менеджер с отдельной строки, которая начинается с его имени заключенном в квадратные скобки).
Если указан формат равный short, пакеты не группируются и отображаются одной строкой.

Поддерживается Zabbix агентом начиная с версии 2.0.
system.swap.in[<устройство>,<тип>]
Статистика файла подкачки в (с устройства в память). Целое число устройство - устройство используемое для файла подкачки (по умолчанию all)
тип - возможные значения:
count (количество swapins), sectors (секторов swapped in), pages (страниц swapped in). Смотрите поддержку по платформам для получения деталей по умолчаниям.
Пример:
⇒ system.swap.in[,pages]

Источником этой информации является:
/proc/swaps, /proc/partitions, /proc/stat (Linux 2.4)
/proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6)
system.swap.out[<устройство>,<тип>]
Статистика файла подкачки из (из памяти в устройство). Целое число. устройство - устройство используемое для файла подкачки (по умолчанию all)
тип - возможные значения:
count (количество swapouts), sectors (секторов swapped out), pages (страниц swapped out). Смотрите поддержку по платформам для получения деталей по умолчаниям.
Пример:
⇒ system.swap.out[,pages]

Источником этой информации является:
/proc/swaps, /proc/partitions, /proc/stat (Linux 2.4)
/proc/swaps, /proc/diskstats, /proc/vmstat (Linux 2.6)
system.swap.size[<устройство>,<тип>]
Размер файла подкачки в байтах или процентах от общего размера. Целое число - для количества байт

Число с плавающей точкой - для процентов.
устройство - устройство используемое для файла подкачки (по умолчанию all)
тип - возможные значения:
free (свободно в файле подкачки, по умолчанию), pfree (свободно в файле подкачки, в процентах), pused (используемое место в файле подкачки, в процентах), total (полный размер файла подкачки), used (используется места в файле подкачки)
Пример:
⇒ system.swap.size[,pfree] → свободно места в файле подкачки в процентах

Обратите внимание, этот ключ может возвращать некорректные данные на виртуализированных (VMware ESXi, VirtualBox) Windows платформах. В этом случае используйте ключ perf_counter[\700(_Total)\702] для получения корректного использования файла подкачки в процентах.

Старое название: system.swap.free, system.swap.total
system.uname
Подробная информация о хосте. Строка Пример возвращаемого значения:
FreeBSD localhost 4.2-RELEASE FreeBSD 4.2-RELEASE #0: Mon Nov i386

Начиная с Zabbix 2.2.0 значение этого элемента получается при помощи системного вызова uname(). Тогда как ранее информация запрашивалась с помощью системного вызова “uname -a” на Unix системах. Следовательно значение этого элемента данных может отличаться от вывода “uname -a” и не включать дополнительные сведения, которые “uname -a” отображает на основе дополнительных источников.
system.uptime
Время работы в секундах. Целое число При настройке элемент данных, используйте единицы измерения s или uptime для получения читаемых значений.
system.users.num
Количество пользователей находящихся в системе. Целое число Для получения значений используется команда who на стороне агента.
vfs.dev.read[<устройство>,<тип>,<режим>]
Статистика чтения диска. Целое число при тип равном: sectors, operations, bytes

Число с плавающей точкой при тип равном: sps, ops, bps
устройство - дисковое устройство (по умолчанию all2)
тип - возможные значения:
sectors, operations, bytes, sps, ops, bps
Этот параметр необходимо указывать, т.к. умолчания отличаются для разных ОС.
sps, ops, bps соответствуют: секторам, операциям, байтам в секунду соответственно
режим - возможные значения:
avg1 (усреднение за минуту, по умолчанию), avg5 (усреднение за 5 минут), avg15 (усреднение за 15 минут).
Третий параметр поддерживается только, если тип один из: sps, ops, bps.
Значения по умолчанию параметра 'Тип' для различных ОС:
AIX - operations
FreeBSD - bps
Linux - sps
OpenBSD - operations
Solaris - bytes

Пример:
⇒ vfs.dev.read[,operations]

ops, bps и sps на поддерживаемых платформах ограничено 8 устройствами (7 отдельных устройств и одно all). Начиная с Zabbix 2.0.1 этот лимит увеличен до 1024 (1023 отдельных устройств и один для all).

По умолчанию используется all первым параметром, который возвращает суммарную статистику, включая: все блочные устройства такие как sda, sbd и их разделы sda1, sda2, sdb3 … и несколько устройств (MD raid) на основе этих блочных устройств/разделов и логические разделы (LVM) на основе этих блочных устройств/разделов. В некоторых случаях возвращаемые значения следует рассматривать как относительные значения (изменяемые во времени), но не как абсолютные значения.

LVM поддерживается начиная с Zabbix 1.8.6.

До Zabbix 1.8.6, можно было использовать только относительные имена устройств (например, sda), начиная с 1.8.6 можно использовать опциональный префикс /dev/ (например, /dev/sda)

Старое название: io[*]
vfs.dev.write[<устройство>,<тип>,<режим>]
Статистика записи на диск. Целое число при тип равном: sectors, operations, bytes

Число с плавающей точкой при тип равном: sps, ops, bps
устройство - дисковое устройство (по умолчанию all1)
тип - возможные значения:
sectors, operations, bytes, sps, ops, bps
Этот параметр необходимо указывать, т.к. умолчания отличаются для разных ОС.
sps, ops, bps соответствуют: секторам, операциям, байтам в секунду соответственно
режим - возможные значения:
avg1 (усреднение за минуту, по умолчанию), avg5 (усреднение за 5 минут), avg15 (усреднение за 15 минут).
Третий параметр поддерживается только если тип один из: sps, ops, bps.
Значения по умолчанию параметра 'Тип' для различных ОС:
AIX - operations
FreeBSD - bps
Linux - sps
OpenBSD - operations
Solaris - bytes

Пример: ⇒ vfs.dev.write[,operations]

ops, bps и sps на поддерживаемых платформах ограничено 8 устройствами (7 отдельных устройств и одно all). Начиная с Zabbix 2.0.1 этот лимит увеличен до 1024 (1023 отдельных устройств и один для all).

По умолчанию используется all первым параметром, который возвращает суммарную статистику, включая: все блочные устройства такие как sda, sbd и их разделы sda1, sda2, sdb3 … и несколько устройств (MD raid) на основе этих блочных устройств/разделов и логические разделы (LVM) на основе этих блочных устройств/разделов. В некоторых случаях возвращаемые значения следует рассматривать как относительные значения (изменяемые во времени), но не как абсолютные значения.

LVM поддерживается начиная с Zabbix 1.8.6.

До Zabbix 1.8.6, можно было использовать только относительные имена устройств (например, sda), начиная с 1.8.6 можно использовать опциональный префикс /dev/ (например, /dev/sda)

Старое название: io[*]
vfs.file.cksum[файл]
Контрольная сумма файла, вычисленная по алгоритму используемом в UNIX cksum. Целое число файл - абсолютный путь к файлу Пример:
⇒ vfs.file.cksum[/etc/passwd]

Пример возвращаемого значения:
1938292000

Старое название: cksum

Ограничение размера файла зависит от поддержки больших файлов.
vfs.file.contents[файл,<кодировка>]
Получение содержимого файла. Текст файл - абсолютный путь к файлу
кодирока - идентификатор кодовой страницы
Возвращает пустую строку, если файл пустой или содержит только LF/CR символы.

Пример:
⇒ vfs.file.contents[/etc/passwd]

Этот элемент данных ограничен файлами не превышающими 64 КБайт.

Поддерживается Zabbix агентом начиная с версии 2.0.
vfs.file.exists[файл]
Проверка существования файла 0 - файл не найден

1 - обычный файл или ссылка (символическая или жесткая) на обычный файл существует.
файл - абсолютный путь к файлу Пример:
⇒ vfs.file.exists[/tmp/application.pid]

Возвращаемое значение зависит от того, что вернет S_ISREG POSIX макрос.

Ограничение размера файла зависит от поддержки больших файлов.
vfs.file.md5sum[файл]
MD5 контрольная сумма файла Строка (MD5 хэш файла) файл -абсолютный путь к файлу Пример:
⇒ vfs.file.md5sum[/usr/local/etc/zabbix_agentd.conf]

Пример возвращаемого значения:
b5052decb577e0fffd622d6ddc017e82

Ограничение (64МБ) на размер файла для этого элемента данных удалено в версии 1.8.6.

Ограничение размера файла зависит от поддержки больших файлов.
vfs.file.regexp[файл,регулярное выражение,<кодировка>,<начальная строка>,<конечная строка>,<вывод>]
Поиск строки в файле. Строка содержащая совпадающую подстроку или то, что определено в дополнительном параметре вывод. файл - абсолютный путь к файлу
регулярное выражение - регулярное выражение GNU
кодировка - идентификатор кодовой страницы
начальная строка - номер первой строки для поиска (по умолчанию, первая строка файла).
конечная строка - номер последней строки для поиска (по умолчанию, последняя строка файла).
вывод - дополнительный шаблон форматирования вывода.
\0 -управляющая последовательность заменяется найденным текстом, тогда
\N (где N=1..9) - управляющая последовательность заменяется N-нной совпадающей группой (или пустой строкой, если N превышает количество найденных групп).
Возвращается только первая совпавшая строка.
Будет возвращена пустая строка, если не найдено совпадений с выражением.

Извлечение содержимого при использовании параметра вывод выполняется агентом.

Параметры начальная строка, конечная строка и вывод поддерживаются начиная с версии 2.2.

Примеры:
⇒ vfs.file.regexp[/etc/passwd,zabbix]
⇒ vfs.file.regexp[/path/to/some/file,”([0-9]+)$”,,3,5,\1]
⇒ vfs.file.regexp[/etc/passwd,^zabbix:.:([0-9]+),,,,\1] → получение ID пользователя zabbix
vfs.file.regmatch[файл,регулярное выражение,<кодировка>,<начальная строка>,<конечная строка>]
Поиск строки в файле. 0 - совпадение не найдено

1 - найдено
файл - абсолютный путь к файлу
регулярное выражение - регулярное выражение GNU
кодировка - идентификатор кодовой страницы
начальная строка - номер первой строки для поиска (по умолчанию, первая строка файла).
конечная строка - номер последней строки для поиска (по умолчанию, последняя строка файла).

Параметры начальная строка, конечная строка поддерживаются с Zabbix 2.2.

Например: ⇒ vfs.file.regmatch[/var/log/app.log,error]
vfs.file.size[файл]
Размер файла (в байтах). Целое число файл - абсолютный путь к файлу Пользователь zabbix должен иметь права на чтение файла

Например:
⇒ vfs.file.size[/var/log/syslog]

Ограничение размера файла зависит от поддержки больших файлов.
vfs.file.time[файл,<режим>]
Информация о времени файла. Целое число (Unix timestamp) файл -полный путь к файлу
режим - один из modify (по умолчанию, время модификации), access - время последнего доступа, change - время последнего изменения
Пример:
⇒ vfs.file.time[/etc/passwd,modify]

Ограничение размера файла зависит от поддержки больших файлов.
vfs.fs.discovery
Список примонтированных файловых систем. Используется низкоуровневым обнаружением. JSON объект Поддерживается Zabbix агентом начиная с версии 2.0.

Макрос {#FSDRIVETYPE} поддерживается в Windows начиная с Zabbix агента версии 3.0.
vfs.fs.inode[fs,<режим>]
Количество или процент inodes. Целое число - для количества

Число с плавающей точной - для процентов
fs - файловая система
режим - один из total (по умолчанию), free, used, pfree (свободно, в процентах), pused (использовано, в процентах)
Пример:
⇒ vfs.fs.inode[/,pfree]

Старое название: vfs.fs.inode.free[*], vfs.fs.inode.pfree[*], vfs.fs.inode.total[*]
vfs.fs.size[fs,<режим>]
Размер диска в байтах или процентах от от общего размера. Целое число - для байт

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

Пример:
⇒ vfs.fs.size[/tmp,free]

Зарезервированное место на файловой системе принимается во внимание и не включено при использовании режима free.

Старые названия: vfs.fs.free[*], vfs.fs.total[*], vfs.fs.used[*], vfs.fs.pfree[*], vfs.fs.pused[*]
vm.memory.size[<режим>]
Размер памяти в байтах или в процентах от общего количества. Целое число - для байт

Число с плавающей точкой - для процентов.
режим - один из total (по умолчанию), active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, wired, used, pused, available, pavailable Этот элемент данных принимает три категории параметров:

1) total - общего количества памяти.
2) специфичные для платформ типы памяти: active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, wired.
3) оценка на уровне пользователя как много памяти используется и доступно: used, pused, available, pavailable.

Смотрите более подробное описание параметров vm.memory.size.

Старые названия: vm.memory.buffers, vm.memory.cached, vm.memory.free, vm.memory.shared, vm.memory.total
web.page.get[хост,<путь>,<порт>]
Получение содержимого веб-страницы. Исходная веб-страница как текст хост - имя хоста
путь - путь к HTML документу (по умолчанию /)
порт - номер порта (по умолчанию 80)
Возвращает пустую строку при ошибке.

Например:
⇒ web.page.get[www.zabbix.com,index.php,80]
web.page.perf[хост,<путь>,<порт>]
Время полной загрузки веб-страницы (в секундах). Число с плавающей точкой хост - имя хоста
путь - путь к HTML документу (по умолчанию /)
порт - номер порта (по умолчанию 80)
Возвращает 0 при ошибке.

Например:
⇒ web.page.perf[www.zabbix.com,index.php,80]
web.page.regexp[хост,<путь>,<порт>,<регулярное выражение>,<длина>,<вывод>]
Поиск строки на веб-странице. Совпадающая строка, или как указан опциональный параметр вывод хост - имя хоста
путь - путь к HTML документу (по умолчанию - /)
порт - номер порта (по умолчанию - 80)
регулярное выражение - регулярное выражение GNU
длина - максимальное количество возвращаемых символов
вывод - дополнительный шаблон форматирования вывода. \0 -управляющая последовательность заменяется найденным текстом, тогда \N (где N=1..9) - управляющая последовательность заменяется N-нной совпадающей группой (или пустой строкой, если N превышает количество найденных групп).
Возвращается пустая строка, если нет совпадений.

Извлечение содержимого согласно дополнительного параметра вывод осуществляется агентом.

Параметр вывод поддерживается начиная с версии 2.2.

Пример:
⇒ web.page.regexp[www.zabbix.com,index.php,80,OK,2]
Заметка специфики для Linux. Zabbix агент должен иметь только права чтения файловой системы /proc. Патчи к ядру для ограничения прав непривилегированных пользователей вы можете найти на странице www.grsecurity.org.

Доступные кодировки

Параметр ​кодировка​ используется для того, чтобы указать кодировку при обработке соответствующих проверок элементов данных, так чтобы полученные данные не были повреждены. Для получения списка поддерживаемых кодировок (идентификаторов кодовых страниц), пожалуйста, обратитесь к соответствующей документации, такой как libiconv (GNU Project) или Microsoft Windows SDK документации по “Идентификаторам кодовых страницы”​. ​

Если задана пустая ​кодировка, тогда по умолчанию используются UTF-8 (языковой стандарт по умолчанию для новых Unix/Linux дистрибутивов, смотрите настройки вашей системы) или ANSI с определенным расширением в системе (Windows).

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

  1. Если используются с пассивным агентов, значение Timeout конфигурации сервера, возможно, потребуется выше, чем Timeout в файле конфигурации агента. В противном случае элемент данных может не возвращать никаких значений по причине того, что запрос сервера к агенту превысит время ожидания раньше агента.