Documentation
Table of Contents
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 - пропуск обработки старых данных (влияет только на недавно созданные элементы данных, которые еще не получали никаких данных). Параметр режим поддерживается начиная с версии 2.0. вывод - дополнительный шаблон форматирования вывода. \0 - управляющая последовательность заменяется найденным текстом, тогда \N (где N=1..9) - управляющая последовательность заменяется N-нной совпадающей группой (или пустой строкой, если N превышает количество найденных групп). Если параметр вывод оставить пустым - будет возвращена вся строка соответствующая регулярному выражению. Заметьте, что все глобальные регулярные выражения исключая "Результат ИСТИНА" всегда возвращают всю строку соответствующую выражению и параметр вывод игнорируется. Параметр вывод поддерживается начиная с Zabbix 2.2. |
Элемент данных должен быть настроен активной проверкой. Если файл не существует или доступ к нему не разрешен, элемент данных переходит в состояние неподдерживается. Извлечение содержимого при использовании параметра вывод выполняется агентом.Примеры: log[/var/log/syslog] log[/var/log/syslog,error] log[/home/zabbix/logs/logfile,,,100] Смотрите дополнительную информацию о мониторинге файлов журналов. |
|
| logrt[файл_regexp,<регулярное выражение>,<кодировка>,<макс. кол-вл строк>,<режим>,<вывод>] | ||||
| Мониторинг файлов журналов (логов) с поддержкой ротации логов. | Журнал (лог). | файл_regexp - абсолютный путь к файлу и регулярное выражение описывающее его имя регулярное выражение - регулярное выражение описывающее требуемый шаблон содержимого кодировка - идентификатор кодовой страницы макс. кол-во строк - максимальное количество новых строк в секунду, которое агент будет отправлять Zabbix серверу или прокси. Этот параметр заменяет значение 'MaxLinesPerSecond' в zabbix_agentd.conf режим - возможные значения: all (по умолчанию), skip - пропуск обработки старых данных (влияет только на недавно созданные элементы данных, которые еще не получали никаких данных). Параметр режим поддерживается начиная с версии 2.0. вывод - дополнительный шаблон форматирования вывода: \0 - управляющая последовательность заменяется найденным текстом, тогда \N (где N=1..9) - управляющая последовательность заменяется N-нной совпадающей группой (или пустой строкой, если N превышает количество найденных групп). Если параметр вывод оставить пустым - будет возвращена вся строка соответствующая регулярному выражению. Заметьте, что все глобальные регулярные выражения исключая "Результат ИСТИНА" всегда возвращают всю строку соответствующую выражению и параметр вывод игнорируется. Параметр вывод поддерживается начиная с Zabbix 2.2. |
Элемент данных должен быть настроен активной проверкой. Ротация журналов основывается на времени последнего изменения файлов. Извлечение содержимого согласно параметра вывод производится на стороне агенте.Примеры: 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". Смотрите дополнительную информацию о мониторинге файлов журналов. |
|
| net.dns[<ip>,имя,<тип>,<время ожидания>,<количество>] | ||||
| Проверка, работает ли DNS сервис. | 0 - DNS не работает (сервер не ответил или ответ DNS некорректен) 1 - DNS работает |
ip - IP адрес DNS сервера (оставьте пустым, чтобы использовать DNS сервера по умолчанию, игнорируется в Windows) имя - проверяемое имя DNS тип - запрашиваемый тип записи (по умолчанию SOA) время ожидания (игнорируется в Windows) - время ожидания ответа в секундах (по умолчанию 1 секунда) количество (игнорируется в Windows) - количество попыток запросов (по умолчанию 2) |
Пример ключа: 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 тип записи SRV поддерживается Zabbix агентом начиная с версий 1.8.6 (Unix) и 2.0.0 (Windows). Национальные доменные имена не поддерживаются вместо них, пожалуйста, используйте имена в IDNA кодировке. Название до Zabbix 2.0 (еще поддерживается): net.tcp.dns |
|
| net.dns.record[<ip>,имя,<тип>,<время ожидания>,<количество>] | ||||
| Выполнение DNS запроса. | Строка символов с требуемым типом информации | ip - IP адрес DNS сервера (оставьте пустым, чтобы использовать DNS сервера по умолчанию, игнорируется в Windows) имя - проверяемое имя DNS тип - запрашиваемый тип записи (по умолчанию SOA) время ожидания (игнорируется в Windows) - время ожидания ответа в секундах (по умолчанию 1 секунда) количество (игнорируется в Windows) - количество попыток запросов (по умолчанию 2) |
Пример ключа: 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 Тип записи SRV поддерживается в Zabbix агенте начиная с версий 1.8.6 (Unix) и 2.0.0 (Windows). Национальные доменные имена не поддерживаются вместо них, пожалуйста, используйте имена в IDNA кодировке. Название до 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 - количество отброшенных пакетов |
Начиная с 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 - количество отброшенных пакетов |
Начиная с 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 - количество отброшенных пакетов |
Примеры: => 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 |
|
| net.tcp.port[<ip>,порт] | ||||
| Проверка возможности создания TCP подключения на указанный номер порта. | 0 - не удалось подключиться 1 - удалось подключиться |
ip - IP адрес (по умолчанию 127.0.0.1) порт - номер порта |
Пример: net.tcp.port[,80] можно использовать для проверки доступности веб-сервера, работающего на 80 порту. Старое название: check_port[*] Для простого тестирования производительности TCP используйте net.tcp.service.perf[tcp,<ip>,<порт>] Обратите внимание, что эти проверки могут привести к дополнительным записям в системных файлах журналов (обычно сессии SMTP и SSH журналируются). |
|
| 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 проверка ищет запрос на вход (с ':' в конце). Старое название: check_service[*] Сервисы https и telnet поддерживается Zabbix с версии 2.0. Сервис ntp корректно работает с версий Zabbix 2.0.15 и Zabbix 2.2.10, несмотря на то, что существовал и в предыдущих версиях. |
|
| net.tcp.service.perf[сервис,<ip>,<порт>] | ||||
| Проверка производительности сервиса. | 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 проверка ищет запрос на вход (с ':' в конце). Старое название: check_service_perf[*] Сервисы https и telnet поддерживается Zabbix с версии 2.0. Сервис ntp корректно работает с версий Zabbix 2.0.15 и Zabbix 2.2.10, несмотря на то существовал и в предыдущих версиях. |
|
| net.udp.listen[порт] | ||||
| Проверка, находится ли UDP порт в состоянии LISTEN. | 0 - не находится в состоянии LISTEN 1 - находится в состоянии LISTEN |
порт - номер UDP порта | Например: net.udp.listen[68] В Linux поддерживается Zabbix агентом начиная с версии 1.8.4 |
|
| 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.intr | ||||
| Прерывания устройств. | Целое число | |||
| system.cpu.load[<cpu>,<режим>] | ||||
| Загрузка CPU. | Число с плавающей точкой | cpu - возможные значения: all (по умолчанию), percpu (общая загрузка делится на количество CPU онлайн) режим - возможные значения: avg1 (усреднение за одну минуту, по умолчанию), avg5 (усреднение за 5 минут), avg15 (усреднение за 15 минут) |
Пример ключа: system.cpu.load[,avg5] Старое название: system.cpu.loadX Параметр percpu поддерживается начиная с Zabbix 2.0.0. |
|
| 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 режим - возможные значения: avg1 (усреднение за одну минуту, по умолчанию), avg5 (усреднение за 5 минут), avg15 (усреднение за 15 минут) |
Пример ключа: 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" на других системах. Параметр тип поддерживется этим элементом данных начиная с версии 1.8.6. Примеры возвращаемых значений: в Linux: system.hostname → linux-w7x1 system.hostname → www.zabbix.com в Windows: system.hostname → WIN-SERV2008-I6 system.hostname[host] → Win-Serv2008-I6LonG Смотрите также более детальную информацию. |
|
| system.hw.chassis[<информация>] | ||||
| Информация о шасси. | Строка | информация - одна из full (по умолчанию), model, serial, type или vendor | Пример: system.hw.chassis[full] Hewlett-Packard HP Pro 3010 Small Form Factor PC CZXXXXXXXX Desktop] Этот ключ зависит от наличия SMBIOS таблицы. Будет выполнена попытка чтения из DMI таблицы с sysfs, если доступ к sysfs будет неудачным, тогда будет попытка чтения напрямую из памяти. Требуются Права root, потому что значение читается из sysfs или памяти. Поддерживается 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 |
Пример: system.hw.macaddr["eth0$",full] [eth0] 00:11:22:33:44:55 Список MAC адресов чьи имена интерфейсов совпадают с заданным в интерфейс регулярным выражением (all список всех интерфейсов). Если формат задан как short, имена интерфейсов и одинаковые MAC адреса не попадают в список. Поддерживается Zabbix агентом начиная с версии 2.0. |
|
| system.localtime[<тип>] | ||||
| Системное время. | Целое число - с тип как utcСтрока - с тип как local. |
utc - (по умолчанию) время с начала Эпохи (00:00:00 UTC, Январь 1, 1970), измеренное в секундах. local - время в формате 'гггг-мм-дд,чч:мм:сс.ннн,+чч:мм' |
Например: => system.localtime[local] → создайте элемент данных, используя этот ключ, и далее используйте его для отображения времени узла сети в элементе комплексного экрана Часы. |
|
| system.run[команда,<режим>] | ||||
| Выполнение указанной команды на узле сети. | Текст с результатом выполнения команды 1 - в режиме nowait (независимо от результата выполнения команды) |
команда - выполняемая команда режим - один из wait (по умолчанию, ожидать завершения выполнения), nowait (не ожидать) |
Возвращается до 512КБ (64КБ до Zabbix 2.0.5), включая пробелы в конце, которые отрезаются. Для корректной обработки, возвращаемые данные должны быть текстом. Пример: system.run[ls -l /] - подробный список файлов в папке root. Обратите внимание: Для того чтобы включить этот функционал, в файле конфигурации агента должна быть указана опция EnableRemoteCommands=1. Смотрите также: Выполнение команд. |
|
| 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 Информация получается с (обратите внимание, на то что не все файлы представлены во всех дистрибутивах): [full] - /proc/version [short] - /proc/version_signature [name] - /etc/issue.net Поддерживается Zabbix агентом начиная с версии 2.0. |
|
| system.sw.packages[<пакет>,<менеджер>,<формат>] | ||||
| Список установленных пакетов. | Текст | пакет - all (по умолчанию) или регулярное выражение менеджер - all (по умолчанию) или конкретный менеджер пакетов формат - full (по умолчанию) или short |
Пример: system.sw.packages[mini,dpkg,short] python-minimal, python2.6-minimal, ubuntu-minimal Список (в алфавитном порядке) установленных пакетов имена которых совпадают с регулярным выражением заданным в пакет (all списки всех). Поддерживаемые менеджеры пакетов: менеджер (выполняемая команда) 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] Источником этой информации является: Linux 2.4: /proc/swaps, /proc/partitions, /proc/stat Linux 2.6: /proc/swaps, /proc/diskstats, /proc/vmstat |
|
| system.swap.out[<устройство>,<тип>] | ||||
| Статистика файла подкачки из (из памяти в устройство). | Целое число. | устройство - устройство используемое для файла подкачки (по умолчанию all) тип - возможные значения: count (количество swapouts), sectors (секторов swapped out), pages (страниц swapped out). Смотрите поддержку по платформам для получения деталей по умолчаниям. |
Пример ключа: system.swap.out[,pages] Источником этой информации является: Linux 2.4: /proc/swaps, /proc/partitions, /proc/stat Linux 2.6: /proc/swaps, /proc/diskstats, /proc/vmstat |
|
| system.swap.size[<устройство>,<тип>] | ||||
| Размер файла подкачки в байтах или процентах от общего размера. | Целое число - для количества байт Число с плавающей точкой - для процентов1. |
устройство - устройство используемое для файла подкачки (по умолчанию all) тип - возможные значения: free (свободно в файле подкачки, по умолчанию), pfree (свободно в файле подкачки, в процентах), pused (используемое место в файле подкачки, в процентах), total (полный размер файла подкачки), used (используется места в файле подкачки) |
Пример ключа: system.swap.size[,pfree] - свободно места в файле подкачки в процентах Если устройство не указано, Zabbix агент будет брать во внимание только swap устройства (файлы), физическая память будет игнорироваться. Например, на Solaris системах команда swap -s включает часть физической памяти и swap устройства (в отличии от swap -l). Старое название: 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. |
Значения по умолчанию параметра "Тип" для различных ОС: FreeBSD - bps Linux - sps OpenBSD - operations Solaris - bytes Пример ключа: vfs.dev.read[,operations] Старое название: io[*] Использование параметров тип ops, bps и sps на поддерживаемых платформах ограничено 8 устройствами (7 отдельных устройств и одно all). Начиная с Zabbix 2.0.1 этот лимит увеличен до 1024 (1023 отдельных устройств и один для all). LVM поддерживается начиная с Zabbix 1.8.6. До Zabbix 1.8.6, можно было использовать только относительные имена устройств (например, sda), начиная с 1.8.6 можно использовать опциональный префикс /dev/ (например, /dev/sda) |
|
| 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. |
Значения по умолчанию параметра "Тип" для различных ОС: FreeBSD - bps Linux - sps OpenBSD - operations Solaris - bytes Пример ключа: vfs.dev.write[,operations] Старое название: io[*] Использование параметров тип ops, bps и sps на поддерживаемых платформах ограничено 8 устройствами (7 отдельных устройств и одно all). Начиная с Zabbix 2.0.1 этот лимит увеличен до 1024 (1023 отдельных устройств и один для all). LVM поддерживается начиная с Zabbix 1.8.6. До Zabbix 1.8.6, можно было использовать только относительные имена устройств (например, sda), начиная с 1.8.6 можно использовать опциональный префикс /dev/ (например, /dev/sda) |
|
| vfs.file.cksum[файл] | ||||
| Контрольная сумма файла, вычисленная по алгоритму используемом в UNIX cksum. | Целое число | файл - абсолютный путь к файлу | Пример возвращаемого значения: 1938292000 Например: vfs.file.cksum[/etc/passwd] Старое название: 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 хэш файла) | файл -абсолютный путь к файлу | Пример возвращаемого значения: b5052decb577e0fffd622d6ddc017e82 Например: vfs.file.md5sum[/usr/local/etc/zabbix_agentd.conf] Ограничение (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. | ||
| 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 | Старое название: vm.memory.buffers, vm.memory.cached, vm.memory.free, vm.memory.shared, vm.memory.total Элемент данных vm.memory.size[] принимает три категории параметров. Первая категория состоит из total - общего количества памяти. Вторая категория содержит специфичные для платформ типы памяти: active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, wired. Третья категория оценивает на уровне пользователя как много памяти используется и доступно: used, pused, available, pavailable. Смотрите более подробное описание параметров vm.memory.size. |
|
| 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] |
|
[1] Ключ system.swap.size может возвращать некорректные данные на виртуализированных (VMware ESXi, VirtualBox) Windows платформах. В этом случае используйте ключ perf_counter[\700(_Total)\702] для получения корректного использования файла подкачки в процентах.
[2] По умолчанию используется all первым параметром для ключей vfs.dev.* и возвращает суммарную статистику, включая: все блочные устройства такие как sda, sbd и их разделы sda1, sda2, sdb3 ... и несколько устройств (MD raid) на основе этих блочных устройств/разделов и логические разделы (LVM) на основе этих блочных устройств/разделов.
В некоторых случаях возвращаемые значения следует рассматривать как относительные значения (изменяемые во времени), но не как абсолютные значения.
Заметка специфики для Linux. Zabbix агент должен иметь только права чтения файловой системы /proc. Патчи к ядру для ограничения прав непривилегированных пользователей вы можете найти на странице www.grsecurity.org.
Доступные кодировки
Параметр кодировка используется для того, чтобы указать кодировку при обработке соответствующих проверок элементов данных, так чтобы полученные данные не были повреждены. Для получения списка поддерживаемых кодировок (идентификаторов кодовых страниц), пожалуйста, обратитесь к соответствующей документации, такой как libiconv (GNU Project) или Microsoft Windows SDK документации по "Идентификаторам кодовых страницы".
Если задана пустая кодировка, тогда по умолчанию используются UTF-8 (языковой стандарт по умолчанию для новых Unix/Linux дистрибутивов, смотрите настройки вашей системы) или ANSI с определенным расширением в системе (Windows).