Эти проверки для сбора данных используют общение с Zabbix агентом.
Существуют пассивные и активные проверки. При настройке элемента данных, вы можете выбрать требуемый тип:
В таблице приводится подробная информация о ключах элементов данных, которые можно использовать с элементами данных Zabbix агента, сгруппированная по семействам элементов данных.
Смотрите также:
Обязательные и опциональные параметры
Параметры без угловых скобок обязательны. Параметры, обозначенные угловыми скобками < >, опциональны.
Использование с утилитами командной строки
Обратите внимание, при тестировании или использовании ключей элементов данных в zabbix_agentd или zabbix_get с командной строки вы также должны учитывать синтаксис командной оболочки.
Например, если какой-то параметр ключа должен быть заключён в двойные кавычки, вам придется явно экранировать эти двойные кавычки, в противном случае они будут обрезаны командной оболочкой как специальные символы и не будут переданы Zabbix утилите.
Примеры:
zabbix_agentd -t 'vfs.dir.count[/var/log,,,"file,dir",,0]'
zabbix_agentd -t vfs.dir.count[/var/log,,,\"file,dir\",,0]
Ключ элемента данных | |||
---|---|---|---|
Описание | Возвращаемое значение | Параметры | Комментарии |
kernel.maxfiles | |||
Максимальное количество открытых файлов, поддерживаемое ОС. | Целое число | ||
kernel.maxproc | |||
Максимальное количество процессов, поддерживаемое ОС. | Целое число | ||
kernel.openfiles | |||
Получение количества открытых в данный момент файловых дескрипторов. | Целое число | Этот элемент данных поддерживается, начиная с Zabbix 6.0. |
Смотрите дополнительную информацию о мониторинге журналов.
Ключ элемента данных | |||
---|---|---|---|
Описание | Возвращаемое значение | Параметры | Комментарии |
log[файл,<регулярное выражение>,<кодировка>,<макс. кол-во строк>,<режим>,<вывод>,<максзадержка>,<опции>,<постоянное_хранилище>] | |||
Мониторинг файлов журналов (логов). | Журнал (лог) | файл — абсолютный путь и имя файла журнала регулярное выражение — регулярное выражение, описывающее необходимый шаблон содержимого кодировка — идентификатор кодовой страницы макс. кол-во строк — максимальное количество новых строк в секунду, которое агент будет отправлять Zabbix серверу или прокси. Этот параметр переопределяет значение «MaxLinesPerSecond» в zabbix_agentd.conf режим (начиная с 2.0 версии) — возможные значения: all (по умолчанию), skip — пропуск обработки старых данных (влияет только на недавно созданные элементы данных, которые ещё не получали никаких данных). вывод (начиная с 2.2 версии) — опциональный шаблон форматирования вывода. \0 — управляющая последовательность заменяется найденной частью текста (начиная от первого символа совпадения, заканчивая символом, где совпадение заканчивается), тогда как \N (где N=1...9) — управляющая последовательность заменяется N-ой совпадающей группой (или пустой строкой, если N превышает количество найденных групп). максзадержка (начиная с версии 3.2) — максимальная задержка в секундах. Тип: число с плавающей точкой. Значения: 0 — (по умолчанию) никогда не игнорировать строки в файлах журналов; > 0.0 — игнорировать более старые строки с целью получения наиболее новых строк, проанализированных в течение «максзадержка» секунд. Перед использованием прочитайте заметки по максзадержка! опции (начиная с версии 4.4.7) — дополнительные опции: mtime-noreread — не уникальные записи, перечитывать только, если размер файла изменяется (игнорировать изменение времени модификации). (Этот параметр устарел, начиная с 5.0.2, так как сейчас mtime игнорируется.) постоянное_хранилище (начиная с версий 5.0.18, 5.4.9, только в zabbix_agentd на Unix системах; не поддерживается в Agent2) — абсолютный путь к директории, где хранить данные долговременного хранения. Смотрите также дополнительные заметки о файлах долговременного хранения. |
Элемент данных должен быть настроен как активная проверка. Если файл не существует или доступ к нему не разрешён, элемент данных перейдёт в неподдерживаемое состояние. Если параметр вывод оставить пустым — будет возвращена вся строка, содержащая текст, соответствующий регулярному выражению. Обратите внимание, что все глобальные регулярные выражения, исключая «Результат ИСТИНА», всегда возвращают всю строку, соответствующую выражению, и параметр вывод игнорируется.Извлечение содержимого согласно параметру вывод производится на стороне агента.Примеры: => log[/var/log/syslog] => log[/var/log/syslog,error] => log[/home/zabbix/logs/logfile,,,100] Использование параметра вывод для извлечения числа из записи в журнале:=> log[/app1/app.log,"task run [0-9.]+ sec, processed ([0-9]+) records, [0-9]+ errors",,,,\1]→ будет соответствовать записи в журнале "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" и на сервер отправится только число «6080». Так как отправляется числовое значение, у этого элемента данных можно изменить «Тип информации» с «Журнал (лог)» на «Числовой (целое положительное)», и это значение можно будет использовать на графиках, в триггерах и т.п. Использование параметра вывод для изменения вывода записи журнала перед отправкой на сервер:=> log[/app1/app.log,"([0-9 :-]+) task run ([0-9.]+) sec, processed ([0-9]+) records, ([0-9]+) errors",,,,"\1 RECORDS: \3, ERRORS: \4, DURATION: \2"]→ будет соответствовать записи в журнале "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" и на сервер будет отправлена изменённая запись "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08". |
log.count[файл,<регулярное выражение>,<кодировка>,<макс. кол-во строк>,<режим>,<максзадержка>,<опции>,<постоянное_хранилище>] | |||
Подсчёт количества совпадающих строк в наблюдаемом файле журнала (логе). | Целое число | файл — абсолютный путь и имя файла журнала регулярное выражение — регулярное выражение, описывающее необходимый шаблон содержимого кодировка — идентификатор кодовой страницы макс. кол-во строк — максимальное количество новых строк в секунду, которое агент будет анализировать (не может превышать 10000). Значением по умолчанию является 10*«MaxLinesPerSecond» в zabbix_agentd.conf. режим — возможные значения: all (по умолчанию), skip — пропуск обработки старых данных (влияет только на недавно созданные элементы данных). максзадержка — максимальная задержка в секундах. Тип: число с плавающей точкой. Значения: 0 — (по умолчанию) никогда не игнорировать строки в файлах журналов; > 0.0 — игнорировать более старые строки с целью получения наиболее новых строк, проанализированных в течение «максзадержка» секунд. Перед использованием прочитайте заметки по максзадержка! опции (начиная с версии 4.4.7) — дополнительные опции: mtime-noreread — не уникальные записи, перечитывать только, если размер файла изменяется (игнорировать изменения времени модификации). (Этот параметр устарел, начиная с 5.0.2, так как сейчас mtime игнорируется.) постоянное_хранилище (начиная с версий 5.0.18, 5.4.9, только в zabbix_agentd на Unix системах; не поддерживается в Agent2) — абсолютный путь к директории, где хранить данные долговременного хранения. Смотрите также дополнительные заметки о файлах долговременного хранения. |
Элемент данных должен быть настроен как активная проверка. Количество совпадающих строк вычисляется за счет новых строк, начиная со времени последней проверки журнала агентом; таким образом, количество зависит от интервала обновления элемента данных. Если файл не существует или доступ к нему не разрешён, элемент данных переходит в неподдерживаемое состояние. Этот элемент данных не поддерживается для Журнала событий Windows. Поддерживается, начиная с Zabbix 3.2.0. |
logrt[регулярное_выражение_файла,<регулярное выражение>,<кодировка>,<макс. кол-во строк>,<режим>,<вывод>,<максзадержка>,<опции>,<постоянное_хранилище>] | |||
Мониторинг файлов журналов (логов) с поддержкой ротации файлов журналов. | Журнал (лог) | регулярное_выражение_файла — абсолютный путь к файлу и регулярное выражение, описывающее его имя. Обратите внимание, что регулярное выражение применяется только к имени файла, и не требуется, чтобы оно соответствовало полному пути (например, /path/to/agent будет соответствовать и файлу zabbix_agentd.log) регулярное выражение — регулярное выражение, описывающее необходимый шаблон содержимого кодировка — идентификатор кодовой страницы макс. кол-во строк — максимальное количество новых строк в секунду, которое агент будет отправлять Zabbix серверу или прокси. Этот параметр переопределяет значение «MaxLinesPerSecond» в zabbix_agentd.conf режим (начиная с 2.0 версии) — возможные значения: all (по умолчанию), skip — пропуск обработки старых данных (влияет только на недавно созданные элементы данных, которые еще не получали никаких данных). вывод (начиная с 2.2 версии) — опциональный шаблон форматирования вывода. \0 — управляющая последовательность заменяется найденной частью текста (начиная от первого символа совпадения, заканчивая символом, где совпадение заканчивается), тогда \N (где N=1...9) — управляющая последовательность заменяется N-ой совпадающей группой (или пустой строкой, если N превышает количество найденных групп). максзадержка (начиная с версии 3.2) — максимальная задержка в секундах. Тип: число с плавающей точкой. Значения: 0 — (по умолчанию) никогда не игнорировать строки в файлах журналов; > 0.0 — игнорировать более старые строки с целью получения наиболее новых строк, проанализированных в течение «максзадержка» секунд. Перед использованием прочитайте заметки по максзадержка! опции (начиная с версии 4.0; mtime-reread, mtime-noreread опции начиная с 4.4.7) — тип ротации файлов журналов и другие опции. Возможные значения: rotate (по умолчанию), copytruncate — обратите внимание, что copytruncate нельзя использовать вместе с maxdelay. В этом случае maxdelay должен быть равен 0 или не указан; смотрите copytruncate заметки, mtime-reread — не уникальные записи, перечитывать, если время модификации или размер изменились (по умолчанию), mtime-noreread — не уникальные записи, перечитывать только, если размер файла изменяется (игнорирование изменения времени модификации). постоянное_хранилище (начиная с версий 5.0.18, 5.4.9, только в zabbix_agentd на Unix системах; не поддерживается в Agent2) — абсолютный путь к директории, где хранить данные долговременного хранения. Смотрите также дополнительные заметки о файлах долговременного хранения. |
Элемент данных должен быть настроен как активная проверка. Ротация журналов основывается на времени последней модификации файлов. Обратите внимание, что logrt разработан для работы с одним активным файлом журнала, с несколькими другими совпадающими уже устаревшими неактивными файлами. Если, например, директория содержит множество активных файлов журналов, по каждому такому файлу необходимо создавать отдельный logrt элемент данных. В противном случае, если один logrt элемент данных подхватит слишком много файлов, это может привести к исчерпанию памяти и сбою в мониторинге. Если параметр вывод оставить пустым — будет возвращена вся строка, содержащая соответствующий регулярному выражению текст. Обратите внимание, что все глобальные регулярные выражения, исключая «Результат ИСТИНА», всегда возвращают всю соответствующую выражению строку, и параметр вывод игнорируется.Извлечение содержимого согласно параметру вывод производится на стороне агента.В параметре регулярное_выражение_файла путь к директории файла журнала и регулярное выражение имени файла журнала должны быть разделены правильным разделителем:- в Windows разделителем должна быть обратная косая черта (\); - в других системах это должна быть прямая косая черта (/). В Windows прямая косая черта может допускаться в других позициях, за исключением той, которая разделяет путь к директории файла журнала и регулярное выражение имени файла журнала (смотрите примеры ниже). Примеры для Windows: => logrt["c:/dir1/dir2/dir3\filename.*\.log","pattern_to_match"] → будет собирать данные из файлов в директории «c:/dir1/dir2/dir3», где имя файла начинается с «filename» и оканчивается любым расширением, соответствующим строке «.log» => logrt["//example.com/share/dir1/dir2/dir3\filename.*\.log","pattern_to_match"] → будет собирать данные из лог-файлов, расположенных на сетевом ресурсе «//example.com/share/dir1/dir2/dir3», где имя файла начинается с «filename» и оканчивается любым расширением, соответствующим строке «.log». Примеры для других систем: => 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». Использование параметра вывод для извлечения числа из записи в журнале:=> logrt[/app1/^test.*log$,"task run [0-9.]+ sec, processed ([0-9]+) records, [0-9]+ errors",,,,\1] → будет соответствовать записи в журнале «2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors», и на сервер отправится только число «6080». Так как отправляется числовое значение, у этого элемента данных можно изменить «Тип информации» с «Журнал (лог)» на «Числовой (целое положительное)», и это значение можно будет использовать на графиках, в триггерах и т.д. Использование параметра вывод для изменения вывода записи журнала перед отправкой на сервер:=> logrt[/app1/^test.*log$,"([0-9 :-]+) task run ([0-9.]+) sec, processed ([0-9]+) records, ([0-9]+) errors",,,,"\1 RECORDS: \3, ERRORS: \4, DURATION: \2"]→ будет соответствовать записи в журнале «2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors», и на сервер отправится изменённая запись «2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08». |
logrt.count[регулярное_выражение_файла ,<регулярное выражение>,<кодировка>,<макс. кол-во строк>,<режим>,<максзадержка>,<опции>,<постоянное_хранилище>] | |||
Подсчёт количества совпадающих строк в наблюдаемом файле журнала (логе) с поддержкой ротации файлов журналов. | Целое число | регулярное_выражение_файла — абсолютный путь к файлу и регулярное выражение, описывающее его имя. Обратите внимание, что регулярное выражение применяется только к имени файла, и не требуется, чтобы оно соответствовало полному пути (например, /path/to/agent будет соответствовать и файлу zabbix_agentd.log) регулярное выражение — регулярное выражение, описывающее необходимый шаблон содержимого кодировка — идентификатор кодовой страницы макс. кол-во строк — максимальное количество новых строк в секунду, которое агент будет анализировать (не может превышать 10000). Значением по умолчанию является 10*«MaxLinesPerSecond» в zabbix_agentd.conf. режим — возможные значения: all (по умолчанию), skip — пропуск обработки старых данных (влияет только на недавно созданные элементы данных). максзадержка — максимальная задержка в секундах. Тип: число с плавающей точкой. Значения: 0 — (по умолчанию) никогда не игнорировать строки в файлах журналов; > 0.0 — игнорировать более старые строки с целью получения наиболее новых строк, проанализированных в течение «максзадержка» секунд. Перед использованием прочитайте заметки по максзадержка! опции (начиная с версии 4.0; mtime-reread, mtime-noreread опции начиная с 4.4.7) — тип ротации файлов журналов и другие опции. Возможные значения: rotate (по умолчанию), copytruncate — обратите внимание, что copytruncate нельзя использовать вместе с maxdelay. В этом случае maxdelay должен быть равен 0 или не указан; смотрите copytruncate заметки, mtime-reread — не уникальные записи, перечитывать, если время модификации или размер изменились (по умолчанию), mtime-noreread — не уникальные записи, перечитывать только, если размер файла изменяется (игнорирование изменения времени модификации). постоянное_хранилище (начиная с версий 5.0.18, 5.4.9, только в zabbix_agentd на Unix системах; не поддерживается в Agent2) — абсолютный путь к директории, где хранить данные долговременного хранения. Смотрите также дополнительные заметки о файлах долговременного хранения. |
Элемент данных должен быть настроен как активная проверка. Количество совпадающих строк вычисляется за счёт новых строк, начиная со времени последней проверки журнала агентом; таким образом, количество зависит от интервала обновления элемента данных. Ротация журналов основывается на времени последней модификации файлов. Этот элемент данных не поддерживается для Журнала событий Windows. Поддерживается, начиная с Zabbix 3.2.0. В параметре регулярное_выражение_файла путь к директории файла журнала и регулярное выражение имени файла журнала должны быть разделены правильным разделителем:- в Windows разделителем должна быть обратная косая черта (\); - в других системах это должна быть прямая косая черта (/). В Windows прямая косая черта может допускаться в других позициях, за исключением той, которая разделяет путь к директории файла журнала и регулярное выражение имени файла журнала (смотрите примеры ниже). Примеры для Windows: => logrt.count["c:/dir1/dir2/dir3\filename.*\.log","pattern_to_match"] → подсчёт количества совпадений с шаблоном «pattern_to_match» в журнальных файлах, расположенных в папке «c:/dir1/dir2/dir3» => logrt.count["//example.com/share/dir1/dir2/dir3\filename.*\.log","pattern_to_match"] → подсчёт количества совпадений с шаблоном «pattern_to_match» в журнальных файлах, расположенных на сетевом ресурсе «//example.com/share/dir1/dir2/dir3». Примеры для других систем: => logrt.count["/home/zabbix/logs/^logfile[0-9]{1,3}$",,,100] → подсчёт количества совпадений с шаблоном «^logfile[0-9]{1,3}$» в журнальных файлах, расположенных в папке «/home/zabbix/logs» => logrt.count["/home/user/^logfile_.*_[0-9]{1,3}$","pattern_to_match","UTF-8",100] → подсчёт того, сколько раз шаблон «pattern_to_match» встречается в журнальных файлах, расположенных в «/home/user». |
Ключ элемента данных | |||
---|---|---|---|
Описание | Возвращаемое значение | Параметры | Комментарии |
modbus.get[точка входа,<id ведомого>,<функция>,<адрес>,<количество>,<тип>,<порядок следования байтов>,<сдвиг>] | |||
Чтение данных Modbus. | JSON объект | точка входа — точка входа, определяемая в виде протокол://строка_подключения id ведомого — ID ведомого функция — функция Modbus адрес — адрес первого регистра, флага или входа количество — количество записей для чтения тип — тип данных порядок следования байтов — настройка порядка следования байтов сдвиг — количество регистров, начиная с «адреса», результаты которых будут отброшены. Смотрите также подробное описание параметров. |
Поддерживается начиная с Zabbix 5.2.0. |
Ключ элемента данных | |||
---|---|---|---|
Описание | Возвращаемое значение | Параметры | Комментарии |
net.dns[<ip>,имя,<тип>,<время ожидания>,<количество>,<протокол>] | |||
Проверка, работает ли DNS сервис. | 0 — DNS не работает (сервер не ответил или ответ DNS некорректен) 1 — DNS работает |
ip — IP адрес DNS сервера (оставьте пустым, чтобы использовались DNS сервера по умолчанию, на Windows поддерживается Zabbix агентом 2, игнорируется Zabbix агентом) имя — проверяемое имя DNS тип — запрашиваемый тип записи (по умолчанию SOA) время ожидания (игнорируется в Windows, если только не используется Zabbix агент 2 версии 6.0.1 или новее) — время ожидания ответа в секундах (по умолчанию 1 секунда) количество (игнорируется в Windows, если только не используется Zabbix агент 2 версии 6.0.1 или новее) — количество попыток запросов (по умолчанию 2) протокол (с версии 3.0) — используемый протокол при выполнении 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 (не поддерживается Zabbix агентом на Windows, Zabbix агентом 2 на всех ОС), HINFO, MINFO, TXT, AAAA, SRV Интерационализированные доменные имена не поддерживаются; вместо них, пожалуйста, используйте имена в IDNA кодировке. Тип записи 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, если только не используется Zabbix агент 2 версии 6.0.1 или новее) имя — проверяемое имя DNS тип — запрашиваемый тип записи (по умолчанию SOA) время ожидания (игнорируется в Windows, если только не используется Zabbix агент 2 версии 6.0.1 или новее) — время ожидания ответа в секундах (по умолчанию 1 секунда) количество (игнорируется в Windows, если только не используется Zabbix агент 2 версии 6.0.1 или новее) — количество попыток запросов (по умолчанию 2) протокол (с версии 3.0) — используемый протокол при выполнении 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 (не поддерживается Zabbix агентом на Windows, Zabbix агентом 2 на всех ОС), HINFO, MINFO, TXT, AAAA, SRV Интернационализированные доменные имена не поддерживаются; вместо них, пожалуйста, используйте имена в IDNA кодировке. Тип записи 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 адрес; или, если в фигурных скобках, GUID сетевого интерфейса (Windows) режим — возможные значения: bytes — количество байт (по умолчанию) packets — количество пакетов errors — количество ошибок dropped — количество отброшенных пакетов overruns (fifo) — количество ошибок FIFO буфера frame — количество ошибок кадрирования пакетов compressed — количество сжатых пакетов, полученных драйвером устройства multicast — количество кадров многоадресного вещания, которые получены драйвером устройства |
В 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 адрес; или, если в фигурных скобках, GUID сетевого интерфейса (Windows) режим — возможные значения: bytes — количество байт (по умолчанию) packets — количество пакетов errors — количество ошибок dropped — количество отброшенных пакетов overruns (fifo) — количество ошибок FIFO буфера collisions (colls) — количество коллизий, обнаруженных на интерфейсе carrier — количество потерь несущей, обнаруженных драйвером устройства compressed — количество сжатых пакетов, переданных драйвером устройства |
В 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 адрес; или, если в фигурных скобках, GUID сетевого интерфейса (Windows) режим — возможные значения: bytes — количество байт (по умолчанию) packets — количество пакетов errors — количество ошибок dropped — количество отброшенных пакетов overruns (fifo) — количество ошибок FIFO буфера compressed — количество сжатых пакетов, переданных или полученных драйвером устройства |
В 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 адрес или DNS имя (по умолчанию 127.0.0.1) порт — номер порта |
Пример: => net.tcp.port[,80] → можно использовать для проверки доступности веб-сервера, работающего на 80 порту. Для простого тестирования производительности TCP используйте net.tcp.service.perf[tcp,<ip>,<порт>] Обратите внимание, что эти проверки могут привести к дополнительным записям в системных файлах журналов (обычно журналируются сессии SMTP и SSH). |
net.tcp.service[сервис,<ip>,<порт>] | |||
Проверка, запущен ли сервис и принимает ли он TCP подключения. | 0 — сервис недоступен 1 — сервис запущен |
сервис — один из: ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https, telnet (смотри подробности) ip — IP адрес или DNS имя (по умолчанию 127.0.0.1) порт — номер порта (по умолчанию используется стандартный номер порта сервиса) |
Пример: => net.tcp.service[ftp,,45] — можно использовать для тестирования доступности FTP сервера на TCP 45 порту. Обратите внимание, что эти проверки могут привести к дополнительным записям в системных файлах журналов (обычно журналируются сессии SMTP и SSH). Проверка шифрованных протоколов (таких как IMAP на 993 порту или POP на 995 порту) в настоящее время не поддерживается. В качестве обходного решения, пожалуйста, для подобных проверок используйте net.tcp.port. Проверка LDAP и HTTPS на платформе Windows поддерживается только Zabbix агентом 2. Обратите внимание, что telnet проверка ищет запрос на вход (с «:» в конце). Сервисы https и telnet поддерживается Zabbix с версии 2.0. |
net.tcp.service.perf[сервис,<ip>,<порт>] | |||
Проверка производительности TCP сервиса. | Число с плавающей точкой 0 — сервис недоступен секунды — количество секунд, потраченное на подключение к сервису |
сервис — один из: ssh, ldap, smtp, ftp, http, pop, nntp, imap, tcp, https, telnet (смотри детали) ip — IP адрес или DNS имя (по умолчанию 127.0.0.1) порт — номер порта (по умолчанию используется стандартный номер порта сервиса) |
Пример: => net.tcp.service.perf[ssh] — можно использовать для тестирования скорости изначального ответа от SSH сервера. Проверка шифрованных протоколов (таких как IMAP на 993 порту или POP на 995 порту) в настоящее время не поддерживается. В качестве обходного решения, пожалуйста, для подобных проверок используйте net.tcp.service.perf[tcp,<ip>,<порт>]. Проверка LDAP и HTTPS на платформе Windows поддерживается только Zabbix агентом 2. Обратите внимание, что telnet проверка ищет запрос на вход (с «:» в конце). Сервисы https и telnet поддерживается Zabbix с версии 2.0. |
net.tcp.socket.count[<локальный_адрес>,<локальный_порт>,<удалённый_адрес>,<удалённый_порт>,<состояние>] | |||
Получение количества TCP сокетов соответствующих заданным параметрам. | Целое число | локальный_адрес — локальный IPv4/6 адрес или CIDR подсеть локальный_порт — номер локального порта или имя сервиса удалённый_адрес — удалённый IPv4/6 адрес или CIDR подсеть удалённый_порт — номер удалённого порта или имя сервиса состояние — состояние соединения (established, syn_sent, syn_recv, fin_wait1, fin_wait2, time_wait, close, close_wait, last_ack, listen, closing) |
Этот элемент данных поддерживается только на Linux как Zabbix агентом, так и агентом 2. В Zabbix агенте 2 этот ключ также поддерживается на 64-битной Windows. Например: => net.tcp.socket.count[,80,,,established] → получение количества соединений на локальный TCP порт 80 в состоянии «established» Этот элемент данных поддерживается, начиная с Zabbix 6.0. |
net.udp.listen[порт] | |||
Проверка, находится ли UDP порт в состоянии LISTEN. | 0 — не находится в состоянии LISTEN 1 — находится в состоянии LISTEN |
порт — номер UDP порта | Например: => net.udp.listen[68] В Linux поддерживается Zabbix агентом, начиная с версии 1.8.4 |
net.udp.service[сервис,<ip>,<порт>] | |||
Проверка, запущен ли сервис и отвечает ли он на UDP запросы. | 0 — сервис недоступен 1 — сервис запущен |
сервис — ntp (смотрите подробности) ip — IP адрес или DNS имя (по умолчанию 127.0.0.1) порт — номер порта (по умолчанию используется стандартный номер порта сервиса) |
Пример: => net.udp.service[ntp,,45] → можно использовать для тестирования доступности NTP сервиса на 45 порту UDP. Этот элемент данных поддерживается, начиная с Zabbix 3.0.0, но ntp сервис был доступен в net.tcp.service[] элементе данных и в предыдущих версиях. |
net.udp.service.perf[сервис,<ip>,<порт>] | |||
Проверка производительности UDP сервиса. | 0 — сервис недоступен секунды — количество секунд, потраченное на ожидание ответа от сервиса |
сервис — ntp (смотрите подробности) ip — IP адрес или DNS имя (по умолчанию 127.0.0.1) порт — номер порта (по умолчанию используется стандартный номер порта сервиса) |
Пример: => net.udp.service.perf[ntp] → можно использовать для тестирования времени отклика от NTP сервиса. Этот элемент данных поддерживается, начиная с Zabbix 3.0.0, но ntp сервис был доступен в net.tcp.service[] элементе данных и в предыдущих версиях. |
net.udp.socket.count[<локальный_адрес>,<локальный_порт>,<удалённый_адрес>,<удалённый_порт>,<состояние>] | |||
Получение количества UDP сокетов, соответствующих заданным параметрам. | Целое число | локальный_адрес — локальный IPv4/6 адрес или CIDR подсеть локальный_порт — номер локального порта или имя сервиса удалённый_адрес — удалённый IPv4/6 адрес или CIDR подсеть удалённый_порт — номер удалённого порта или имя сервиса состояние — состояние соединения (established, unconn) |
Этот элемент данных поддерживается только на Linux как Zabbix агентом, так и агентом 2. В Zabbix агенте 2 этот ключ также поддерживается на 64-битной Windows. Например: => net.tcp.socket.count[,,,,established] → возвращает количество UDP сокетов в состоянии «established» Этот элемент данных поддерживается, начиная с Zabbix 6.0. |
Ключ элемента данных | |||
---|---|---|---|
Описание | Возвращаемое значение | Параметры | Комментарии |
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 часов, удаляются из коллектора. Обратите внимание, что в случае, когда агент скомпилирован на Solaris без поддержки зон, если задать параметр зона значением current (или по умолчанию) и запустить его на более новом Solaris, где зоны поддерживаются, то агент вернёт NOTSUPPORTED (агент не может ограничить результаты в пределах только текущей зоны). Однако, значение all в этом случае поддерживается.Этот ключ поддерживается, начиная с Zabbix 3.0.0, и также доступен на нескольких платформах (смотри Поддерживаемые элементы данных по платформам). |
proc.mem[<имя>,<пользователь>,<режим>,<cmdline>,<тип памяти>] | |||
Количество памяти, используемое процессом, в байтах. | Целое число — с режимом , равным max, min, sumДробное число — с режимом , равным avg |
имя — имя процесса (по умолчанию все процессы) пользователь — имя пользователя (по умолчанию все пользователи) режим — возможные значения: avg, max, min, sum (по умолчанию) cmdline — фильтр по командной строке (является регулярным выражением) тип памяти — тип памяти, используемый процессом. |
Примеры: => proc.mem[,root] — память, используемая всеми процессами, запущенными под пользователем «root» => proc.mem[zabbix_server,zabbix] — память, используемая всеми процессами zabbix_server, запущенными под пользователем zabbix => proc.mem[,oracle,max,oracleZABBIX] — память, используемая наиболее жадным до памяти процессом, запущенным под пользователем oracle и имеющим oracleZABBIX в командной строке Обратите внимание: Когда несколько процессов используют разделяемую память, сумма используемой процессами памяти может дать в результате большие, нереальные значения. Смотрите заметки по выбору процессов с параметрами имя и cmdline (специфика для Linux).Когда этот элемент данных вызывается из командной строки и содержит параметр командной строки (например, при использовании тестового режима агента: zabbix_agentd -t proc.mem[,,,apache2] ), будет засчитан один дополнительный процесс, так как агент посчитает самого себя.Параметр тип памяти поддерживается на нескольких платформах начиная с Zabbix 3.0.0. |
proc.num[<имя>,<пользователь>,<состояние>,<cmdline>,<зона>] | |||
Количество процессов. | Целое число | имя — имя процесса (по умолчанию все процессы) пользователь — имя пользователя (по умолчанию все пользователи) состояние (опции disk и trace с версии 3.4.0) — возможные значения: all (по умолчанию), disk — непрерывный сон, run — в процессе работы, sleep — прерываемый сон, trace — остановлен, zomb — зомби cmdline — фильтр по командной строке (является регулярным выражением) зона — целевая зона: current (по умолчанию), all. Этот параметр поддерживается только на платформе Solaris. |
Примеры ключей: => proc.num[,mysql] — количество процессов, выполняемых под пользователем mysql => proc.num[apache2,www-data] — количество процессов apache2, выполняемых под пользователем www-data => proc.num[,oracle,sleep,oracleZABBIX] — количество процессов в спящем состоянии, выполняемых под пользователем oracle и имеющих oracleZABBIX в командной строке Смотрите заметки по выбору процессов с параметрами имя и cmdline (специфика для Linux).В Windows поддерживаются только параметры имя и пользователь .Когда этот элемент данных вызывается из командной строки и содержит параметр командной строки (например, при использовании тестового режима агента: zabbix_agentd -t proc.num[,,,apache2] ), будет засчитан один дополнительный процесс, так как агент посчитает самого себя.Обратите внимание, что в случае, когда агент скомпилирован на Solaris без поддержки зон, если задать параметр зона значением current (или по умолчанию) и запустить его на более новом Solaris, где зоны поддерживаются, тогда агент вернёт NOTSUPPORTED (агент не может ограничить результаты в пределах только текущей зоны). Однако, значение all в этом случае поддерживается. |
Ключ элемента данных | |||
---|---|---|---|
Описание | Возвращаемое значение | Параметры | Комментарии |
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 поддерживается, начиная с версии 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 (с версии 2.0; общая загрузка делится на количество CPU онлайн) режим — возможные значения: avg1 (усреднение за одну минуту, по умолчанию), avg5, avg15 |
Когда процесс коллектора запускается на Zabbix агенте для Windows, для этого элемента данных инициализируются и далее используются следующие счётчики производительности: \System\Processor Queue Length Пример: => system.cpu.load[,avg5] |
system.cpu.num[<тип>] | |||
Количество CPU. | Целое число | тип — возможные значения: online (по умолчанию), max |
Пример: => system.cpu.num |
system.cpu.switches | |||
Количество переключений контекста. | Целое число | ||
system.cpu.util[<cpu>,<тип>,<режим>,<логический_или_физический>] | |||
Утилизация CPU в процентах. | Число с плавающей точкой | cpu — <номер CPU> или all (по умолчанию) тип — возможные значения: user (по умолчанию), idle, nice, system (по умолчанию для Windows), iowait, interrupt, softirq, steal, guest (на ядрах Linux 2.6.24 и выше), guest_nice (на ядрах Linux 2.6.33 и выше). Смотрите также подробную информацию о зависимости от платформы касательно этого параметра. режим — возможные значения: avg1 (усреднение за одну минуту, по умолчанию), avg5, avg15 логический_или_физический (с версии 5.0.3; только на AIX) — возможные значения: logical (по умолчанию), physical. Этот параметр поддерживается только на AIX. |
На Windows значение получается с использованием счётчика производительности Processor Time. Обратите внимание, начиная с Windows 8 его Менеджер Задач отображает утилизацию CPU, используя счётчик производительности Processor Utility, тогда как предыдущие версии использовали счётчик Processor Time (смотрите более подробно). Пример: => system.cpu.util[0,user,avg5] Старое наименование: system.cpu.idleX, system.cpu.niceX, system.cpu.systemX, system.cpu.userX |
system.hostname[<тип>, <преобразование>] | |||
Системное имя хоста. | Строка | тип (до версии 5.4.7 поддерживался только для Windows) — возможные значения: netbios (по умолчанию на Windows), host (по умолчанию на Linux), shorthost (с версии 5.4.7; возвращает часть имени хоста до первой точки, всю строку для имён без точек). преобразование (с версии 5.4.7) — возможные значения: none (по умолчанию), lower (конвертация в нижний регистр) |
Значение опрашивается на платформе Windows либо функцией GetComputerName() (для netbios), либо функцией gethostname() (для host), а на остальных системах — забирая значение «nodename» из вывода системного API uname(). Примеры возвращаемых значений: в Linux: => system.hostname → linux-w7x1 => system.hostname → example.com => system.hostname[shorthost] → example в Windows: => system.hostname → WIN-SERV2008-I6 => system.hostname[host] → Win-Serv2008-I6LonG => system.hostname[host,lower] → 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 или памяти. Поддерживается, начиная с версии 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 устройств. | Текст | тип (с версии 2.0) — pci (по умолчанию) или usb | Пример: => system.hw.devices[pci] → 00:00.0 Host bridge: Advanced Micro Devices [AMD] RS780 Host Bridge [...] Возвращает вывод утилит lspci или lsusb (выполняются без каких либо параметров). |
system.hw.macaddr[<интерфейс>,<формат>] | |||
Список MAC адресов. | Строка | интерфейс — all (по умолчанию) или регулярное выражение формат — full (по умолчанию) или short |
Список MAC адресов интерфейсов, чьи имена совпадают с заданным в параметре интерфейс регулярным выражением (all список всех интерфейсов).Пример: => system.hw.macaddr["eth0$",full] => [eth0] 00:11:22:33:44:55 Если формат задан значением short, имена интерфейсов и одинаковые MAC адреса не попадут в список.Поддерживается, начиная с версии 2.0. |
system.localtime[<тип>] | |||
Системное время. | Целое число — с тип как utcСтрока — с тип как local. |
type (с версии 2.0) — возможные значения: utc — (по умолчанию) время с начала Эпохи (00:00:00 UTC, Январь 1, 1970), измеренное в секундах. local — время в формате 'гггг-мм-дд,чч:мм:сс.ннн,+чч:мм' |
Необходимо использовать только как пассивную проверку. Например: => system.localtime[local] → создайте элемент данных, используя этот ключ, и далее используйте его для отображения времени узла сети в элементе комплексного экрана Часы. |
system.run[команда,<режим>] | |||
Выполнение указанной команды на узле сети. | Текст с результатом выполнения команды 1 — c режимом со значением nowait (независимо от результата выполнения команды) |
команда — выполняемая команда режим — возможные значения: wait — ожидать завершения выполнения (по умолчанию), nowait — не ожидать |
Возвращаемое значение элемента данных является стандартным выводом совместно со стандартным выводом ошибок, которые получены от команды. Код завершения не проверяется. Смотрите также: Выполнение команд. Для корректной обработки, возвращаемое командой значение должно иметь тип данных текст . Пустой результат также допустим.Возвращаемое значение ограничено 16 МБ (включая конечные пробелы, которые усекаются); также применяются ограничения баз данных. Обратите внимание, что элементы данных system.run по умолчанию запрещены. Узнайте, как их разрешить. Пример: => system.run[ls -l /] → подробный список файлов в корневой папке. |
system.stat[ресурс,<тип>] | |||
Системная статистика. | Целое число или число с плавающей точкой | ent — количество процессорных единиц, выделенных на ресурс (число с плавающей точкой) kthr,<тип> — информация о состояниях потоков ядра: r — среднее количество запускаемых потоков ядра (число с плавающей точкой) b — среднее количество потоков ядра, помещённых в очередь ожидания Менеджера Виртуальный Памяти (с плавающей точкой) memory,<тип> — информация об использовании виртуальной и реальной памяти: avm — активные виртуальные страницы (целое число) fre — размер свободного списка (целое число) page,<тип> — информация об ошибках страниц и активности страниц: fi — количество загрузок страниц в секунду (число с плавающей точкой) fo — количество выгрузок страниц в секунду (число с плавающей точкой) pi — страницы, загруженные из пространства подкачки (число с плавающей точкой) po — страницы, выгруженные в пространство подкачки (число с плавающей точкой) fr — освобождённые страницы (замена страниц) (число с плавающей точкой) sr — количество страниц, сканированных алгоритмом замещения страниц (число с плавающей точкой) faults,<тип> — соотношение ловушек и прерываний: in — прерывания устройства (число с плавающей точкой) sy — системные вызовы (число с плавающей точкой) cs — переключения контекста потока ядра (число с плавающей точкой) cpu,<тип> — распределение процессорного времени в процентах: us — пользовательское время (число с плавающей точкой) sy — системное время (число с плавающей точкой) id — время простоя (число с плавающей точкой) wa — время простоя, в ходе которого система обрабатывала запросы I/O диска/NFS (число с плавающей точкой) pc — количество использованных физических процессоров (число с плавающей точкой) ec — процент потреблённой выделенной ёмкости (число с плавающей точкой) lbusy — отображает утилизацию в процентах для логических процессор(ов), которая произошла при выполнении уровней пользователя и системы (число с плавающей точкой) app — отображает количество доступных физических процессоров в общем пуле (число с плавающей точкой) disk,<тип> — статистика о дисках: bps — показывает объём данных, переданных (прочитанных или записанных) на диск в байтах в секунду (целое число) tps — показывает количество передач за секунду, которые произошли на физическом диске/ленте (число с плавающей точкой) |
Этот элемент данных поддерживается только на AIX. Обратите внимание на следующие ограничения в этих элементах данных: => system.stat[cpu,app] — поддерживается только на AIX LPAR с типом «Shared» => system.stat[cpu,ec] — поддерживается на AIX LPAR с типом «Shared» и «Dedicated» («Dedicated» всегда возвращает 100 (процентов)) => system.stat[cpu,lbusy] — поддерживается только на AIX LPAR с типом «Shared» => system.stat[cpu,pc] — поддерживается на AIX LPAR с типом «Shared» и «Dedicated» => system.stat[ent] — поддерживается на AIX LPAR с типом «Shared» и «Dedicated» |
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) Параметр PRETTY_NAME из /etc/os-release на системах, которые его поддерживают, или /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 (используется места в файле подкачки) Обратите внимание, что pfree, pused не поддерживаются на Windows, если размер файла подкачки нулевой. Смотрите также подробную информацию о зависимости от платформы по этому параметру. |
Пример: => system.swap.size[,pfree] → свободное место в файле подкачки в процентах Если устройство не указано, Zabbix агент будет брать во внимание только swap устройства (файлы), физическая память будет игнорироваться. Например, на Solaris системах команда swap -s включает часть физической памяти и swap устройства (в отличие от swap -l). Обратите внимание, этот ключ может возвращать некорректные данные размера места в файле подкачки, а также в процентах, на виртуализированных (VMware ESXi, VirtualBox) Windows платформах. В этом случае вы можете использовать ключ perf_counter[\700(_Total)\702] для получения корректного использования файла подкачки в процентах. |
system.uname | |||
Идентификация системы. | Строка | Пример возвращаемого значения (Unix): FreeBSD localhost 4.2-RELEASE FreeBSD 4.2-RELEASE #0: Mon Nov i386 Пример возвращаемого значения (Windows): Windows ZABBIX-WIN 6.0.6001 Microsoft® Windows Server® 2008 Standard Service Pack 1 x86 В Unix, начиная с Zabbix 2.2.0, значение этого элемента данных извлекается при помощи системного вызова uname(). Ранее эта информация запрашивалась с помощью системного вызова «uname -a». Значение этого элемента данных может отличаться от вывода «uname -a» и может не включать дополнительную информацию, которую «uname -a» выводит на основании на других источников. В Windows, начиная с Zabbix 3.0, значение этого элемента данных извлекается при помощи классов WMI Win32_OperatingSystem и Win32_Processor. Ранее эта информация запрашивалась при помощи непостоянных вызовов Windows API и недокументированных ключей реестра. Имя ОС (включая редакцию) может быть переведено на пользовательский язык интерфейса. Некоторые версии Windows содержат символы товарных знаков и дополнительные пробелы. Обратите внимание, что этот элемент данных в Windows возвращает архитектуру ОС, тогда как в Unix он возвращает архитектуру CPU. |
|
system.uptime | |||
Время работы в секундах. | Целое число | При настройке элемента данных используйте единицы измерения s или uptime для получения читабельных значений. | |
system.users.num | |||
Количество пользователей, находящихся в системе. | Целое число | Для получения значений используется команда who на стороне агента. |
Ключ элемента данных | |||
---|---|---|---|
Описание | Возвращаемое значение | Параметры | Комментарии |
vfs.dev.discovery | |||
Список блочных устройств и их типов. Используется низкоуровневым обнаружением. | JSON объект | Этот элемент данных поддерживается только на платформе Linux. Поддерживается с Zabbix 4.4.0. |
|
vfs.dev.read[<устройство>,<тип>,<режим>] | |||
Статистика чтения диска. | Целое число при тип равном: sectors, operations, bytesЧисло с плавающей точкой при тип равном: sps, ops, bpsОбратите внимание: Если используется интервал обновления три часа и более2, будет всегда возвращаться значение «0» |
устройство — дисковое устройство (по умолчанию all 3) тип — возможные значения: sectors, operations, bytes, sps, ops, bps Обратите внимание, что поддержка и умолчания параметра тип зависят от платформы. Смотрите подробную информацию о зависимости от платформы.sps, ops, bps соответствуют: секторам, операциям, байтам в секунду соответственно режим — возможные значения: avg1 (усреднение за минуту, по умолчанию), avg5 (усреднение за 5 минут), avg15 (усреднение за 15 минут). Третий параметр поддерживается только, если тип один из: sps, ops, bps. |
Вы можете использовать относительные имена устройств (например, sda ), а также необязательный префикс /dev/ (например, /dev/sda ).Поддерживаются логические тома LVM. Значения по умолчанию параметра «тип» для различных ОС: 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). |
vfs.dev.write[<устройство>,<тип>,<режим>] | |||
Статистика записи на диск. | Целое число при тип равном: sectors, operations, bytesЧисло с плавающей точкой при тип равном: sps, ops, bpsОбратите внимание: Если используется интервал обновления три часа и более2, будет всегда возвращаться значение «0» |
устройство — дисковое устройство (по умолчанию all 3) тип — возможные значения: sectors, operations, bytes, sps, ops, bps Обратите внимание, что поддержка и умолчания параметра тип зависят от платформы. Смотрите подробную информацию о зависимости от платформы.sps, ops, bps соответствуют: секторам, операциям, байтам в секунду соответственно режим — возможные значения: avg1 (усреднение за минуту, по умолчанию), avg5 (усреднение за 5 минут), avg15 (усреднение за 15 минут). Третий параметр поддерживается только если тип один из: sps, ops, bps. |
Вы можете использовать относительные имена устройств (например, sda ), а также необязательный префикс /dev/ (например, /dev/sda ).Поддерживаются логические тома LVM. Значения по умолчанию параметра «тип» для различных ОС: 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). |
vfs.dir.count[директория,<regex_вкл>,<regex_искл>,<типы_вкл>,<типы_искл>,<макс_глубина>,<мин_размер>,<макс_размер>,<мин_возраст>,<макс_возраст>,<regex_искл_директории>] | |||
Количество элементов в директории. | Целое число | директория — абсолютный путь к директории regex_вкл — регулярное выражение, описывающее шаблон включаемых имён сущностей (файлов, директорий и символических ссылок); если пусто, включается всё (по умолчанию) regex_искл — регулярное выражение, описывающее шаблон исключаемых имён сущностей (файлов, директорий и символических ссылок); если пусто (по умолчанию), исключения не применяются типы_вкл — перечисление типов элементов в директории, которые будут подсчитываться, возможные значения: file — обычный файл, dir — поддиректория, sym — символическая ссылка, sock — сокет, bdev — блочное устройство, cdev — устройство посимвольного ввода-вывода, fifo — FIFO, dev — синоним к "bdev,cdev", all — все вышеупомянутые типы (по умолчанию), т.е. "file,dir,sym,sock,bdev,cdev,fifo". Несколько типов необходимо разделять запятой и весь список заключать в двойные кавычки. типы_искл — перечисление типов элементов (см. <типы_вкл>) в директории, которые НЕ будут подсчитываться. Если какие-либо типы элементов указаны как в <типы_вкл>, так и в <типы_искл>, элементы этих типов в директории НЕ будут подсчитаны. макс_глубина — максимальная глубина сканируемых поддиректорий. -1 (по умолчанию) — без ограничения, 0 — не опускаться в поддиректории. мин_размер — минимальный размер (в байтах) подсчитываемых файлов. Файлы, которые меньше этого значения, не будут подсчитаны. Можно использовать суффиксы памяти. макс_размер — максимальный размер (в байтах) подсчитываемых файлов. Файлы, которые больше этого значения, не будут подсчитаны. Можно использовать суффиксы памяти. мин_возраст — минимальный возраст (в секундах) подсчитываемых элементов директории. Более свежие элементы не будут подсчитаны. Можно использовать суффиксы времени. макс_возраст — максимальный возраст (в секундах) подсчитываемых элементов директории. Элементы этого возраста и более старые (время модификации) не будут подсчитаны. Можно использовать суффиксы времени. regex_искл_директории — регулярное выражение, описывающее шаблон имён исключаемых директорий. Всё содержимое директории будет исключено (в отличие от regex_искл) |
Переменные среды, такие как %APP_HOME%, $HOME и %TEMP%, не поддерживаются. Псевдо-директории «.» и «..» никогда не учитываются. При обходе директорий символические ссылки никогда не используются. В Windows символические ссылки директорий пропускаются. Оба параметра regex_вкл и regex_искл применяются к файлам и директориям при вычислении общего количества, но игнорируются при выборе поддиректорий для обхода (если regex_вкл равен "(?i)^.+\.zip$" и макс_глубина не задана, то будут обойдены все поддиректории, но посчитаны только файлы с типом zip).Время выполнения ограничено значением времени ожидания в конфигурации агента. Так как сканирование большой директории может занять более длительное время, чем время ожидания, то никакие данные не возвратятся, и элемент данных будет отмечен как «Не поддерживается». Результат частичного подсчёта не возвращается. При фильтрации по размеру только обычные файлы имеют осмысленные размеры. В Linux и BSD директории также имеют ненулевые размеры (в основном несколько Кб). Устройства имеют нулевые размеры; например, размер /dev/sda1 не отражает размер соответствующего раздела. Поэтому, при использовании параметров <мин_размер> и <макс_размер> рекомендуется указать <типы_вкл> равным "file", чтобы избежать неожиданностей.Примеры: ⇒ vfs.dir.count[/dev] — мониторинг количества устройств в /dev (Linux) ⇒ vfs.dir.count["C:\Users\ADMINI~1\AppData\Local\Temp"] — мониторинг количества файлов во временной директории (Windows) Поддерживается с Zabbix 4.0.0. |
vfs.dir.get[директория,<regex_вкл>,<regex_искл>,<типы_вкл>,<типы_искл>,<макс_глубина>,<мин_размер>,<макс_размер>,<мин_возраст>,<макс_возраст>,<regex_искл_директории>] | |||
Список содержимого директории. | JSON | директория — абсолютный путь к директории regex_вкл — регулярное выражение, описывающее шаблон включаемых имён сущностей (файлов, директорий и символических ссылок); если пусто, включается всё (по умолчанию) regex_искл — регулярное выражение, описывающее шаблон исключаемых имён сущностей (файлов, директорий и символических ссылок); если пусто (по умолчанию), исключения не применяются типы_вкл — перечисление типов элементов в директории, которые будут добавлены в список, возможные значения: file — обычный файл, dir — поддиректория, sym — символическая ссылка, sock — сокет, bdev — блочное устройство, cdev — устройство посимвольного ввода-вывода, fifo — FIFO, dev — синоним к "bdev,cdev", all — все вышеупомянутые типы (по умолчанию), т.е. "file,dir,sym,sock,bdev,cdev,fifo". Несколько типов необходимо разделять запятой и весь список заключать в двойные кавычки. типы_искл — перечисление типов элементов (см. <типы_вкл>) в директории, которые НЕ будут добавлены в список. Если какие-либо типы элементов указаны как в <типы_вкл>, так и в <типы_искл>, элементы этих типов в директории НЕ будут добавлены в список. макс_глубина — максимальная глубина сканируемых поддиректорий. -1 (по умолчанию) — без ограничения, 0 — не опускаться в поддиректории. мин_размер — минимальный размер (в байтах) добавляемых в список файлов. Файлы, которые меньше этого значения, не будут добавлены в список. Можно использовать суффиксы памяти. макс_размер — максимальный размер (в байтах) добавляемых в список файлов. Файлы, которые больше этого значения, не будут добавлены в список. Можно использовать суффиксы памяти. мин_возраст — минимальный возраст (в секундах) добавляемых в список элементов директории. Более свежие элементы не будут добавлены в список. Можно использовать суффиксы времени. макс_возраст — максимальный возраст (в секундах) добавляемого в список элемента директории. Элементы этого возраста и более старые (время модификации) не будут добавлены в список. Можно использовать суффиксы времени. regex_искл_директории — регулярное выражение, описывающее шаблон имён исключаемых директорий. Всё содержимое директории будет исключено (в отличие от regex_искл) |
Переменные среды, такие как %APP_HOME%, $HOME и %TEMP%, не поддерживаются. Псевдо-директории «.» и «..» никогда не учитываются. При обходе директорий символические ссылки никогда не используются. В Windows символические ссылки директорий пропускаются. Оба параметра regex_вкл и regex_искл применяются к файлам и директориям при генерации списка содержимого директории, но игнорируются при выборе поддиректорий для обхода (если regex_вкл равен "(?i)^.+\.zip$" и макс_глубина не задана, то будут обойдены все поддиректории, но в список будут добавлены только файлы с типом zip).Время выполнения ограничено значением времени ожидания в конфигурации агента. Так как сканирование большой директории может занять более длительное время, чем время ожидания, то никакие данные не возвратятся, и элемент данных будет отмечен как «Не поддерживается». Частичный список не возвращается. При фильтрации по размеру только обычные файлы имеют осмысленные размеры. В Linux и BSD директории также имеют ненулевые размеры (в основном несколько Кб). Устройства имеют нулевые размеры; например, размер /dev/sda1 не отражает размер соответствующего раздела. Поэтому, при использовании параметров <мин_размер> и <макс_размер> рекомендуется указать <типы_вкл> равным "file", чтобы избежать неожиданностей.Примеры: ⇒ vfs.dir.get[/dev] — получение списка устройств в /dev (Linux) ⇒ vfs.dir.get["C:\Users\ADMINI~1\AppData\Local\Temp"] — получение списка файлов во временной директории (Windows) Поддерживается с Zabbix 6.0.0. |
vfs.dir.size[директория,<regex_вкл>,<regex_искл>,<режим>,<макс_глубина>,<regex_искл_директории>] | |||
Размер директории (в байтах). | Целое число | директория — абсолютный путь к директории regex_вкл — регулярное выражение, описывающее шаблон включаемых имён сущностей (файлов, директорий и символических ссылок); если пусто, включается всё (по умолчанию) regex_искл — регулярное выражение, описывающее шаблон исключаемых имен сущностей (файлов, директорий и символических ссылок); если пусто (по умолчанию), исключения не применяются режим — возможные значения: apparent (по умолчанию) — получение реальных размеров файлов вместо использования диска (работает как du -sb директория ), disk — получение использования диска (работает как du -s -B1 директория ). В отличие от команды du, элемент данных vfs.dir.size при вычислении размера директории учитывает скрытые файлы (работает как du -sb .[^.]* * в пределах директории).макс_глубина — максимальная глубина сканируемых поддиректорий. -1 (по умолчанию) — без ограничения, 0 — не опускаться в поддиректории. regex_искл_директории — регулярное выражение, описывающее шаблон имён исключаемых директорий. Всё содержимое директории будет исключено (в отличие от regex_искл) |
Подсчитываются только те директории, к которым пользователь zabbix имеет по крайней мере права чтения. В Windows любая символическая ссылка пропускается, а жёсткие ссылки учитываются только один раз. При наличии больших директорий или медленных дисков этот элемент данных может превысить время ожидания из-за настройки Timeout в файлах конфигурации агента и сервера/прокси. При необходимости увеличьте эти значения времени ожидания. Примеры: ⇒ vfs.dir.size[/tmp,log] — вычисление размеров всех файлов в /tmp, которые содержат в своём имени «log» ⇒ vfs.dir.size[/tmp,log,^.+\.old$] — вычисление размеров всех файлов в /tmp, которые содержат в своём имени «log», исключая файлы с именами, оканчивающимися на «.old» Ограничение размера файлов зависит от наличия поддержки больших файлов. Поддерживается, начиная с Zabbix 3.4.0. |
vfs.file.cksum[файл,<режим>] | |||
Контрольная сумма файла, вычисленная по алгоритму, используемому в UNIX cksum. | Целое число — с режимом в значении crc32Строка — с режимом в значениях md5, sha256 |
файл — абсолютный путь к файлу режим — crc32 (по умолчанию), md5, sha256 |
Пример: => vfs.file.cksum[/etc/passwd] Пример возвращаемых значений (для crc32/md5/sha256 соответственно): 675436101 9845acf68b73991eb7fd7ee0ded23c44 ae67546e4aac995e5c921042d0cf0f1f7147703aa42bfbfb65404b30f238f2dc Ограничение размера файла зависит от поддержки больших файлов. Параметр режим поддерживается с Zabbix 6.0. |
vfs.file.contents[файл,<кодировка>] | |||
Получение содержимого файла. | Текст | файл — абсолютный путь к файлу кодировка — идентификатор кодовой страницы |
Возвращает пустую строку, если файл пустой или содержит только LF/CR символы. Возвращаемое значение ограничено 16 МБ (включая конечные пробелы, которые усекаются); также применяются ограничения баз данных. Маркер последовательности байтов (BOM) исключён из вывода. Пример: => vfs.file.contents[/etc/passwd] |
vfs.file.exists[файл,<типы_вкл>,<типы_искл>] | |||
Проверка существования файла. | 0 — файл не найден 1 — файл заданного типа существует. |
файл — абсолютный путь к файлу типы_вкл — список включаемых типов файлов, возможные значения: file (обычный файл, по умолчанию (если типы_искл не задан)), dir (директория), sym (символическая ссылка), sock (сокет), bdev (блочное устройство), cdev (устройство посимвольного ввода-вывода), fifo (FIFO), dev (синоним к "bdev,cdev"), all (все вышеупомянутые типы, по умолчанию если типы_искл задан). типы_искл — список исключаемых типов файлов, смотрите типы_вкл для получения возможных значений (по умолчанию никакие типы не исключаются) |
Несколько типов необходимо разделять запятой и весь список заключить в "" кавычки. На Windows двойные кавычки необходимо экранировать обратной косой чертой «\» и весь ключ элемента данных должен быть заключен в двойные кавычки при использовании утилиты zabbix_get.exe или agent2 в командной строке. Если какие-либо типы записей указаны как в <типы_вкл>, так и в <типы_искл>, файлы этих типов будут исключены. Примеры: => vfs.file.exists[/tmp/application.pid] => vfs.file.exists[/tmp/application.pid,"file,dir,sym"] => vfs.file.exists[/tmp/application_dir,dir] Ограничение размера файла зависит от поддержки больших файлов. Обратите внимание, элемент данных может стать неподдерживаемым на Windows, если искомая директория ищется в несуществующей директории, например, vfs.file.exists[C:\нет\dir,dir] (где «нет» не существует). |
vfs.file.get[файл] | |||
Получение информации о файле. | Объект JSON | файл — абсолютный путь к файлу | Поддерживаемые типы файлов в UNIX-подобных системах: обычный файл, директория, символическая ссылка, сокет, блочное устройство, устройство посимвольного ввода-вывода, FIFO Поддерживаемые типы файлов на Windows: обычный файл, директория, символическая ссылка Например: => vfs.file.get[/etc/passwd] → получение JSON с информацией о файле /etc/passwd (тип, пользователь, права доступа, SID, uid и т.п.) Ограничение размера файла зависит от поддержки больших файлов. Поддерживается с Zabbix 6.0. |
vfs.file.md5sum[файл] | |||
MD5 контрольная сумма файла | Строка (MD5 хеш-сумма файла) | файл — абсолютный путь к файлу | Пример: => vfs.file.md5sum[/usr/local/etc/zabbix_agentd.conf] Пример возвращаемого значения: b5052decb577e0fffd622d6ddc017e82 Ограничение размера файла зависит от поддержки больших файлов. |
vfs.file.owner[файл,<тип_владельца>,<тип_результата>] | |||
Получение владельца файла. | Строка символов | файл — абсолютный путь к файлу тип_владельца — user (по умолчанию) или group (только в Unix) тип_результата — name (по умолчанию) или id; в случае с id — получение uid/gid на Unix, SID на Windows |
Пример: => vfs.file.owner[/tmp/zabbix_server.log] → получение владельца файла /tmp/zabbix_server.log => vfs.file.owner[/tmp/zabbix_server.log,,id] → получение ID владельца файла /tmp/zabbix_server.log Ограничение размера файла зависит от поддержки больших файлов. Поддерживается с Zabbix 6.0. |
vfs.file.permissions[файл] | |||
Получение строки из 4 цифр, содержащую восьмеричное число с правами доступа Unix. | Строка | файл — абсолютный путь к файлу | Не поддерживается на Windows. Пример: => vfs.file.permissions[/etc/passwd] → получение прав доступа к /etc/passwd, например, «0644» Ограничение размера файла зависит от поддержки больших файлов. Поддерживается с Zabbix 6.0. |
vfs.file.regexp[файл,регулярное выражение,<кодировка>,<начальная строка>,<конечная строка>,<вывод>] | |||
Поиск строки в файле. | Строка, содержащая совпадающую подстроку, или то, что определено в дополнительном параметре вывод . |
файл — абсолютный путь к файлу регулярное выражение — регулярное выражение, описывающее требуемый шаблон кодировка — идентификатор кодовой страницы начальная строка —- номер первой строки для поиска (по умолчанию, первая строка файла). конечная строка — номер последней строки для поиска (по умолчанию, последняя строка файла). вывод — дополнительный шаблон форматирования вывода. \0 — управляющая последовательность заменяется найденной частью текста (начиная от первого символа совпадения, заканчивая символом, где совпадение заканчивается), тогда \N (где N=1..9) — управляющая последовательность заменяется N-ной совпадающей группой (или пустой строкой, если N превышает количество найденных групп). |
Возвращается только первая совпавшая строка. Если совпадений с выражением не найдено, будет возвращена пустая строка. Маркер последовательности байтов (BOM) исключается из вывода. Извлечение содержимого при использовании параметра вывод выполняется агентом.Параметры начальная строка , конечная строка и вывод поддерживаются, начиная с версии 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 — найдено |
файл — абсолютный путь к файлу регулярное выражение — регулярное выражение описывающее требуемый шаблон кодировка — идентификатор кодовой страницы начальная строка — номер первой строки для поиска (по умолчанию, первая строка файла). конечная строка — номер последней строки для поиска (по умолчанию, последняя строка файла). |
Маркер последовательности байтов (BOM) игнорируется. Параметры начальная строка , конечная строка поддерживаются с Zabbix 2.2.Например: => vfs.file.regmatch[/var/log/app.log,error] Ограничение размера файла зависит от поддержки больших файлов. |
vfs.file.size[файл,<режим>] | |||
Размер файла (в байтах). | Целое число | файл — абсолютный путь к файлу режим — возможные значения: bytes (по умолчанию) или lines (пустые строки также считаются) |
Пользователь zabbix должен иметь права на чтение файла Например: => vfs.file.size[/var/log/syslog] Ограничение размера файла зависит от поддержки больших файлов. Параметр режим поддерживается с Zabbix 6.0. |
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. Макрос {#FSLABEL} поддерживается на Windows с Zabbix 6.0. |
|
vfs.fs.get | |||
Список примонтированных файловых систем, их типов, размеров дисков и статистики по inode. Можно использовать низкоуровневым обнаружением. | Объект JSON | Макрос {#FSLABEL} поддерживается на Windows с Zabbix 6.0. Начиная с версии Zabbix 6.0.11, этот элемент данных может сообщать о файловых системах с нулевым количеством файловых дескрипторов (inode), что может случаться на файловых системах с динамическим количеством файловых дескрипторов (например, btrfs). |
|
vfs.fs.inode[fs,<режим>] | |||
Количество или процент inodes. | Целое число — для количества Число с плавающей точной — для процентов |
fs — файловая система режим — возможные значения: total (по умолчанию), free, used, pfree (свободно, в процентах), pused (использовано, в процентах) |
Начиная с Zabbix 6.0.11, этот элемент данных не будет переходить в неподдерживаемое состояние в режимах pfree/pused, если количество inode-ов станет нулевым, что может случаться на файловых системах с динамическим количеством файловых дескрипторов (например, btrfs). Вместо этого для таких файловых систем значения pfree/pused будут сообщаться как «100» и «0» соответственно. Пример: => vfs.fs.inode[/,pfree] |
vfs.fs.size[fs,<режим>] | |||
Дисковое пространство в байтах или процентах от общего размера. | Целое число — для байт Число с плавающей точкой — для процентов. |
fs — файловая система режим — возможные значения: total (по умолчанию), free, used, pfree (доступно, в процентах), pused (использовано, в процентах) |
Если файловая система не примонтирована, будет возвращён размер локальной файловой системы, где расположена точка монтирования. Пример: => vfs.fs.size[/tmp,free] Зарезервированное место на файловой системе принимается во внимание и не включено при использовании режима free. |
Ключ элемента данных | |||
---|---|---|---|
Описание | Возвращаемое значение | Параметры | Комментарии |
vm.memory.size[<режим>] | |||
Размер памяти в байтах или в процентах от общего количества. | Целое число — для байт Число с плавающей точкой — для процентов. |
режим — возможные значения: total (по умолчанию), active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, slab, wired, used, pused (использовано, в процентах), available, pavailable (доступно, в процентах) Смотрите также информацию о поддержке в зависимости от платформы и дополнительную информацию по этому параметру . |
Этот элемент данных принимает три категории параметров: 1) total — общее количество памяти. 2) зависимые от платформы типы памяти: active, anon, buffers, cached, exec, file, free, inactive, pinned, shared, slab, wired. 3) оценка на уровне пользователя, как много памяти используется и доступно: used, pused, available, pavailable. |
Ключ элемента данных | |||
---|---|---|---|
Описание | Возвращаемое значение | Параметры | Комментарии |
web.page.get[хост,<путь>,<порт>] | |||
Получение содержимого веб-страницы. | Исходная веб-страница в виде текста (включая заголовки) | хост — имя хоста или URL (в виде схема://хост:порт/путь , где обязателен только хост).Допустимые схемы URL: http, https4. При отсутствии схемы будет обрабатываться как http. Если указан URL, тогда путь и порт должны быть пустыми. При подключении к серверам, которые требуют аутентификацию, возможность указать имя пользователя / пароль, например: http://user:[email protected] , имеется только с поддержкой cURL 4.В именах хостов поддерживается punycode. путь — путь к HTML документу (по умолчанию /) порт — номер порта (по умолчанию 80 для HTTP) |
Этот элемент данных становится неподдерживаемым, если заданный в хост ресурс не существует или недоступен.хост может быть именем хоста, доменным именем, адресом IPv4 или IPv6. Но для поддержки IPv6 адресов Zabbix агент должен быть скомпилирован с включённой поддержкой IPv6.Примеры: => web.page.get[www.zabbix.com,index.php,80] => web.page.get[https://www.zabbix.com] => web.page.get[https://blog.zabbix.com/?s=zabbix] => web.page.get[localhost:80] => web.page.get["[::1]/server-status"] |
web.page.perf[хост,<путь>,<порт>] | |||
Время полной загрузки веб-страницы (в секундах). | Число с плавающей точкой | хост — имя хоста или URL (в виде схема://хост:порт/путь , где обязателен только хост).Допустимые схемы URL: http, https4. При отсутствии схемы будет обрабатываться как http. Если указан URL, тогда путь и порт должны быть пустыми. При подключении к серверам, которые требуют аутентификацию, возможность указать имя пользователя / пароль, например: http://user:[email protected] , имеется только с поддержкой cURL 4.В именах хостов поддерживается punycode. путь — путь к HTML документу (по умолчанию /) порт — номер порта (по умолчанию 80 для HTTP) |
Этот элемент данных становится неподдерживаемым, если заданный в хост ресурс не существует или недоступен.хост может быть именем хоста, доменым именем, адресом IPv4 или IPv6. Но для поддержки IPv6 адресов Zabbix агент должен быть скомпилирован с включённой поддержкой IPv6.Примеры: => web.page.perf[www.zabbix.com,index.php,80] => web.page.perf[https://www.zabbix.com] |
web.page.regexp[хост,<путь>,<порт>,регулярное выражение,<длина>,<вывод>] | |||
Поиск строки на веб-странице. | Совпадающая строка, или указанная опциональным параметром вывод |
хост — имя хоста или URL (в виде схема://хост:порт/путь , где обязателен только хост).Допустимые схемы URL: http, https4. При отсутствии схемы будет обрабатываться как http. Если указан URL, тогда путь и порт должны быть пустыми. При подключении к серверам, которые требуют аутентификацию, возможность указать имя пользователя / пароль, например: http://user:[email protected] , имеется только с поддержкой cURL 4.В именах хостов поддерживается punycode. путь — путь к HTML документу (по умолчанию /) порт — номер порта (по умолчанию 80 для HTTP) регулярное выражение — регулярное выражение, описывающее требуемый шаблон длина — максимальное количество возвращаемых символов вывод — дополнительный шаблон форматирования вывода. \0 — управляющая последовательность заменяется найденной частью текста (начиная от первого символа совпадения, заканчивая символом, где совпадение заканчивается), тогда как \N (где N=1..9) — управляющая последовательность заменяется N-ой совпадающей группой (или пустой строкой, если N превышает количество найденных групп). |
Этот элемент данных становится неподдерживаемым, если заданный в хост ресурс не существует или недоступен.хост может быть именем хоста, доменным именем, адресом IPv4 или IPv6. Но для поддержки IPv6 адресов Zabbix агент должен быть скомпилирован с включённой поддержкой IPv6.Извлечение содержимого при использовании параметра вывод производится на стороне агента.Параметр вывод поддерживается, начиная с версии 2.2.Примеры: => web.page.regexp[www.zabbix.com,index.php,80,OK,2] => web.page.regexp[https://www.zabbix.com,,,OK,2] |
Ключ элемента данных | |||
---|---|---|---|
Описание | Возвращаемое значение | Параметры | Комментарии |
agent.hostmetadata | |||
Метаданные узла сети агента. | Строка | Получение значения параметров HostMetadata или HostMetadataItem, или пустая строка, если ничего не задано. Поддерживается начиная с Zabbix 6.0. |
|
agent.hostname | |||
Имя узла сети агента. | Строка | Возвращает: Пассивной проверкой — имя первого узла сети, указанного в параметре Hostname в файле конфигурации агента; Активной проверкой — текущее значение имени хоста. |
|
agent.ping | |||
Проверка доступности агента. | Ничего — недоступен 1 — доступен |
Используйте триггерную функцию nodata() для проверки недоступности узла сети. | |
agent.variant | |||
Проверка разновидности агента (Zabbix агент или Zabbix агент 2). | Целое число | Примеры возвращаемых значений: 1 — Zabbix агент 2 — Zabbix агент 2 |
|
agent.version | |||
Версия Zabbix агента. | Строка | Пример возвращаемого значения: 6.0.3 |
|
zabbix.stats[<ip>,<порт>] | |||
Возвращает набор внутренних метрик с удалённого Zabbix сервера или прокси. | JSON объект | ip — список IP/DNS/сетевой маски опрашиваемых удалённо серверов / прокси (по умолчанию 127.0.0.1) порт — порт опрашиваемого удалённо сервера / прокси (по умолчанию 10051) |
Обратите внимание, что запрос статистики будет приниматься только с адресов, которые перечислены в параметре «StatsAllowedIP» сервера / прокси на удалённом экземпляре. Этим элементом данных возвращается выбранный набор внутренних метрик. Для получения более подробных сведений смотрите удалённый мониторинг статистики Zabbix. |
zabbix.stats[<ip>,<порт>,queue,<от>,<до>] | |||
Возвращает количество наблюдаемых элементов данных в очереди, которые задерживаются на удалённом Zabbix сервере или прокси. | JSON объект | ip — список IP/DNS/сетевой маски опрашиваемых удалённо серверов / прокси (по умолчанию 127.0.0.1) порт — порт опрашиваемого удалённо сервера / прокси (по умолчанию 10051) queue — константа (используется как есть) от — с задержкой как минимум (по умолчанию от 6 секунд) до — с задержкой как максимум (по умолчанию до бесконечности) |
Обратите внимание, что запрос статистики будет приниматься только с адресов, которые перечислены в параметре «StatsAllowedIP» сервера / прокси на удалённом экземпляре. |
1 Специфичное для Linux примечание. Zabbix агент должен иметь права «только на чтение» на файловую систему /proc. Патчи к ядру от www.grsecurity.org ограничивают права доступа непривилегированных пользователей.
2 vfs.dev.read[]
, vfs.dev.write[]
: Zabbix агент будет прерывать «протухшие» подключения к устройствам, если значения элементов данных не опрашиваются более 3 часов. Это может произойти, если система имеет устройства с динамически меняющимися путями или если устройство было удалено вручную. Обратите также внимание, что эти элементы данных при использовании интервала обновления от 3 часов и более всегда будут возвращать значение «0».
3 vfs.dev.read[]
, vfs.dev.write[]
: Если первым параметром используется параметр по умолчанию all, тогда ключ вернёт суммарную статистику, включая все блочные устройства, такие как sda, sdb и их разделы (sda1, sda2, sdb3…) и несколько устройств (MD raid) на основе этих блочных устройств/разделов и логические разделы (LVM) на основе этих блочных устройств/разделов. В этих случаях возвращаемые значения следует рассматривать как относительные значения (изменяемые во времени), но не как абсолютные значения.
4 SSL (HTTPS) поддерживается только, если агент скомпилирован с поддержкой cURL. В противном случае элемент данных станет неподдерживаемым.
Чтобы убедиться, что полученные данные не повреждены, вы можете в параметре «кодировка» указать корректную кодировку для обработки проверки (например в «vfs.file.contents»). Список поддерживаемых кодировок (идентификаторов кодовых страниц) можно найти в документации к libiconv (GNU Project) или в документации к Microsoft Windows SDK по «Идентификаторам кодовых страниц».
Если кодировка не задана в параметре кодировка
, то применяются следующие стратегии преобразования: