10 Выполнение команд

Zabbix использует единый функционал для внешних проверок, пользовательских параметров, элементов данных system.run, пользовательских скриптов оповещений, удаленных команд и глобальных скриптов.

Этапы выполнения

Команда/скрипт выполняется одинаково как на Unix так и на Windows платформах:

1. Zabbix (родительский процесс) cоздаёт канал связи
2. Zabbix устанавливает данный канал связи для вывода данных от создаваемого дочернего процесса
3. Zabbix создаёт дочерний процесс (выполняет команду/скрипт)
4. Создается новая группа процесса (в Unix) или задача (в Windows) для дочернего процесса
5. Zabbix считывает из канала данные по истечении установленного времени ожидания или до момента, когда запись прекратится (ВСЕ обработчики/файловые дескрипторы закрыты). Обратите внимание, что дочерний процесс может создать еще некоторое количество процессов и выйти до того, как эти процессы завершатся или будет закрыт обработчик/файловый дескриптор.
6. Если установленное время ожидания не было достигнуто, Zabbix ждет завершения начального дочернего процесса или ждет достижения установленного времени ожидания.
7. Если начальный дочерний процесс завершил свою работу и время ожидания не вышло, тогда Zabbix проверяет код вызода начального дочернего процесса и сравнивает его с 0 (ненулевое значение считается ошибкой выполнения, только для пользовательских скриптов оповещений, удаленных команд и пользовательских скриптов выполняемых на Zabbix сервере и Zabbix прокси)
8. На этот момент подразумевается, что всё выполнено и всё дерево процессов (т.е. группа процессов или задача) завершены.

Все двойные кавычки и обратная косая черта в команде экранируются обратной косой чертой и вся команда заключается в двойные кавычки.

Проверка кода выхода

Код выхода проверяется на соответствие следующим условиям:

• Только для пользовательских скриптов оповещений, удаленных команд и пользовательских скриптов выполняемых на Zabbix сервере и Zabbix прокси.
• Любой код выхода, отличный от 0 считается ошибкой выполнения.
• Содержимое стандарного вывода ошибки и стандартного вывода собирается при ошибочных выполнениях и доступно в веб-интерфейсе (где отображается результат выполнения).
• Добавляется дополнительная запись в журнал удаленных команд на Zabbix сервере, чтобы сохранить вывод выполнения скрипта, эту возможность можно включить, используя параметр агента LogRemoteCommands.

Возможные сообщения в веб-интерфейсе и записи в журналах при ошибочных командах/скриптах:

• Содержимое стандарного вывода ошибки и стандартного вывода при ошибочных выполнениях (если имеется).
• "Process exited with code: N." (при пустом выводе и коде выхода отлично от 0).
• "Process killed by signal: N." (при завершении процесса сигналом, только на Linux).
• "Process terminated unexpectedly." (при завершениях процесса по неизвестным причинам).

Подробнее о:

• Внешние проверки
• Пользовательские параметры
• Элементы данных system.run items
• Custom alert scripts
• Пользовательские скрипты оповещений
• Глобальные скрипты

See also

• External checks
• User parameters
• system.run items
• Custom alert scripts
• Remote commands
• Global scripts