Documentation
Table of Contents
1. Условия
Обзор
Можно задать, что действие будет выполнено, только если событие удовлетворяет определённому набору условий. Условия задаются при настройке действия.
Сопоставление условий чувствительно к регистру.
Действия на триггеры
В действиях на события триггеров можно использовать следующие условия:
| Тип условия | Поддерживаемые операторы | Описание |
|---|---|---|
| Группа узлов сети (Host group) |
равно не равно |
Укажите группу узлов сети или исключение группы узлов сети. равно — событие относится к указанной группе узлов сети. не равно — событие не относится к указанной группе узлов сети. При указании родительской группы узлов сети косвенным образом будут выбраны все вложенные группы узлов сети. Чтобы выбрать только родительскую группу, все вложенные группы необходимо дополнительно перечислить с оператором не равно. |
| Шаблон (Template) |
равно не равно |
Укажите шаблон или исключение шаблона. равно — событие относится к триггеру, унаследованному из указанного шаблона. не равно — событие не относится к триггеру, унаследованному из указанного шаблона. |
| Узел сети (Tag name) |
равно не равно |
Укажите узел сети или исключение узла сети. равно — событие относится к указанному узлу сети. не равно — событие не относится к указанному узлу сети. |
| Имя тега (Tag name) |
равно не равно содержит не содержит |
Укажите тег события или исключение тега события. равно — событие имеет указанный тег. не равно — событие не имеет указанный тег. содержит — событие имеет тег, который содержит указанную строку. не содержит — событие не имеет тега, который содержит указанную строку. |
| Значение тега (Tag value) |
равно не равно содержит не содержит |
Укажите комбинацию тега события и его значения или исключение комбинации тега и значения. равно — событие имеет указанные тег и значение. не равно — событие не имеет указанные тег и значение. содержит — событие содержит указанные строки тега и значения. не содержит — событие не содержит указанные строки тега и значения. |
| Триггер (Trigger) |
равно не равно |
Укажите триггер или исключение триггера. равно — событие сгенерировано указанным триггером. не равно — событие сгенерировано любым триггером, отличным от указанного. |
| Имя события (Event name) |
содержит не содержит |
Укажите строку в имени события, сгенерированного триггером, или исключение строки. По умолчанию имя события совпадает с именем триггера, если в настройках триггера не было указано настраиваемого имени события. содержит — событие содержит в имени указанную строку. не содержит — указанная строка не содержится в имени события. Примечание: Заданное значение будет сравниваться с именем события со всеми раскрытыми макросами. |
| Важность триггера (Trigger severity) |
равно не равно больше чем или равно меньше чем или равно |
Укажите важность триггера. равно — совпадает с указанной важностью триггера. не равно — не совпадает с указанной важностью триггера. больше чем или равно — выше или равно указанной важности триггера. меньше чем или равно — ниже или равно указанной важности триггера. |
| Период времени (Time period) |
в не в |
Укажите период времени или исключение периода времени. в — время события в течение указанного периода времени. не в — время события не входит в указанный период времени. Смотрите страницу Спецификации периодов времени для получения более подробных сведений об этом формате. Поддерживаются пользовательские макросы. |
| Проблема подавлена (Problem is suppressed) |
нет да |
Укажите, если проблема подавлена (не отображается) по причине обслуживания узла сети. нет — проблема не подавлена. да — проблема подавлена. |
Действия на услуги
В действиях на события услуг можно использовать следующие условия:
| Тип условия | Поддерживаемые операторы | Описание |
|---|---|---|
| Услуга (Service) |
равно не равно |
Укажите услугу или исключение услуги. равно — событие относится к указанной услуге. не равно — событие не относится к указанной услуге. При указании родительской услуги косвенным образом будут выбраны все дочерние услуги. Чтобы выбрать только родительскую услугу, все вложенные услуги необходимо дополнительно перечислить с оператором не равно. |
| Имя услуги (Service name) |
содержит не содержит |
Укажите строку из имени услуги или исключение строки. содержит — событие произошло от услуги, которая содержит в имени указанную строку. не содержит — указанная строка не содержится в имени услуги. |
| Имя тега услуги (Service tag name) |
равно не равно содержит не содержит |
Укажите тег события или исключение тега события. Теги на события услуг можно добавить в настройках услуги в разделе Теги. равно — событие имеет указанный тег. не равно — событие не имеет указанный тег. содержит — событие имеет тег, который содержит указанную строку. не содержит — событие не имеет тега, который содержит указанную строку. |
| Значение тега услуги (Service tag value) |
равно не равно содержит не содержит |
Укажите комбинацию тега события и его значение или исключение комбинации тега и значения. Теги на события услуг можно добавить в настройках услуги в разделе Теги. равно — событие имеет указанные тег и значение. не равно — событие не имеет указанные тег и значение. содержит — событие содержит указанные строки тега и значения. не содержит — событие не содержит указанные строки тега и значения. |
Обязательно задайте шаблоны сообщений для действий на услуги в меню Оповещения → Способы оповещений. В противном случае, оповещения не будут отправлены.
Действия на обнаружение
В действиях на события обнаружения можно использовать следующие условия:
| Тип условия | Поддерживаемые операторы | Описание |
|---|---|---|
| IP узла сети (Host IP) |
равно не равно |
Укажите диапазон IP адресов или исключение диапазона у обнаруженного узла сети. равно — IP адрес узла сети в указанном диапазоне. не равно — IP адрес узла сети не из указанного диапазона. Доступны следующие форматы: Одиночный IP: 192.168.1.33 Диапазон IP адресов: 192.168.1-10.1-254 маска IP: 192.168.4.0/24 Список диапазонов: 192.168.1.1-254, 192.168.2.1-100, 192.168.2.200, 192.168.4.0/24 В формате списка поддерживаются пробелы. |
| Тип сервиса (Service type) |
равно не равно |
Укажите тип сервиса обнаруженного сервиса или исключение типа сервиса. равно — совпадает с обнаруженным сервисом. не равно — не совпадает с обнаруженным сервисом. Доступные типы сервисов: SSH, LDAP, SMTP, FTP, HTTP, HTTPS, POP, NNTP, IMAP, TCP, Zabbix агент, SNMPv1 агент, SNMPv2 агент, SNMPv3 агент, ICMP пинг, telnet. |
| Порт сервиса (Service port) |
равно не равно |
Укажите диапазон TCP портов или исключение диапазона у обнаруженного узла сети. равно — порт сервиса из указанного диапазона. не равно — порт сервиса не из указанного диапазона. |
| Правило обнаружения (Discovery rule) |
равно не равно |
Укажите правило обнаружения или исключение правила обнаружения. равно — использование указанного правила обнаружения. не равно — использование любого другого правила обнаружения, отличного от указанного. |
| Проверка обнаружения (Discovery check) |
равно не равно |
Укажите проверку обнаружения или исключение проверки обнаружения. равно — использование указанной проверки обнаружения. не равно — использование любой другой проверки обнаружения, отличной от указанной. |
| Обнаруженный объект (Discovery object) |
равно | Укажите обнаруженный объект. равно — совпадает с обнаруженным объектом (устройством или сервисом). |
| Состояние обнаружения (Discovery status) |
равно | Доступен (Up) — совпадает с событиями «Узел сети доступен» и «Сервис доступен». Недоступен (Down) — совпадает с событиями «Узел сети недоступен» и «Сервис недоступен». Обнаружен (Discovered) — совпадает с событиями «Узел сети обнаружен» и «Сервис обнаружен». Потерян (Lost) — совпадает с событиями «Узел сети потерян» и «Сервис потерян». |
| Доступен/Недоступен (Uptime/Downtime) |
больше чем или равно меньше чем или равно |
Время доступности для событий «Узел сети доступен» и «Сервис доступен». Время недоступности для событий «Узел сети недоступен» и «Сервис недоступен». больше чем или равно — больше или совпадает. Параметр задается в секундах. меньше чем или равно — меньше или совпадает. Параметр задается в секундах. |
| Полученное значение (Received value) |
равно не равно больше чем или равно меньше чем или равно содержит не содержит |
Укажите полученное значение от проверки агента (Zabbix, SNMP) в правиле обнаружения. Регистрозависимое сравнение строк. Если в правиле заданы несколько проверок Zabbix агента или SNMP, проверяется каждое полученное от них значения (каждая проверка генерирует новое событие, которое сопоставляется со всеми условиями). равно — совпадает с указанным значением. не равно — не совпадает с указанным значением. больше чем или равно — больше или совпадает с указанным значением. меньше чем или равно — меньше или совпадает с указанным значением. содержит — содержит указанную подстроку. Параметр задается в виде строки. не содержит — не содержит указанную подстроку. Параметр задается строкой. |
| Прокси (Proxy) |
равно не равно |
Укажите прокси или исключение прокси. равно — используется указанный прокси. не равно — используется любой другой прокси отличный от указанного. |
Проверки сервисов в правиле обнаружения, которые приводят к событиям обнаружения, не выполняются одновременно. Поэтому, если в действии настроено несколько значений для условий Тип сервиса, Порт сервиса или Полученное значение, они будут сравниваться с одним событием обнаружения за раз, но не будут сравниваться с несколькими событиями одновременно. В результате действия с несколькими значениями по одним и тем же типам проверок могут быть выполнены некорректно.
Действия на авторегистрацию
В действиях на события авторегистрации активного агента можно использовать следующие условия:
| Тип условия | Поддерживаемые операторы | Описание |
|---|---|---|
| Метаданные узлов сети (Host metadata) |
содержит не содержит совпадает не соответствует |
Укажите метаданные узла сети или метаданные узла сети для исключения. содержит — метаданные узла сети содержат указанную строку. не содержит — метаданные узла сети не содержат указанную строку. Метаданные узла сети можно задать в файле конфигурации агента. совпадает — метаданные узла сети соответствуют регулярному выражению. не соответствует — метаданные узла сети не соответствуют регулярному выражению. |
| Имя узла сети (Host name) |
содержит не содержит совпадает не соответствует |
Укажите имя узла сети или имя узла сети для исключения. содержит — имя узла сети содержит указанную строку. не содержит — имя узла сети не содержит указанную строку. совпадает — имя узла сети соответствует регулярному выражению. не соответствует — имя узла сети не соответствует регулярному выражению. |
| Прокси (Proxy) |
равно не равно |
Укажите прокси или прокси для исключения: равно — используется указанный прокси. не равно — используется любой другой прокси, отличный от указанного. |
Действия на внутренние события
В действиях на внутренние события можно использовать следующие условия:
| Тип условия | Поддерживаемые операторы | Описание |
|---|---|---|
| Тип события (Event type) |
равно | Элемент данных в состоянии "не поддерживается" (Item in "not supported" state) — соответствует событию, когда элемент данных переходит из состояния «активировано» в состояние «не поддерживается». Правило низкоуровневого обнаружения в состоянии "не поддерживается" (Low-level discovery rule in "not supported" state) — соответствует событию, когда правило низкоуровневого обнаружения переходит из состояния «активировано» в состояние «не поддерживается». Триггер в состоянии "неизвестно" (Trigger in "unknown" state) — соответствует событию, когда триггер переходит из состояния «активировано» в состояние «неизвестно». |
| Группа узлов сети (Host group) |
равно не равно |
Укажите группу узлов сети или группу узлов сети для исключения. равно — событие относится к указанной группе узлов сети. не равно — событие не относится к указанной группе узлов сети. |
| Имя тега (Tag name) |
равно не равно содержит не содержит |
Укажите тег события или исключение тега события. равно — событие имеет указанный тег. не равно — событие не имеет указанный тег. содержит — событие имеет тег, который содержит указанную строку. не содержит — событие не имеет тега, который содержит указанную строку. |
| Значение тега (Tag value) |
равно не равно содержит не содержит |
Укажите комбинацию тега события и его значения или исключение комбинации тега и значения. равно — событие имеет указанные тег и значение. не равно — событие не имеет указанные тег и значение. содержит — событие содержит указанные строки тега и значения. не содержит — событие не содержит указанные строки тега и значения. |
| Шаблон (Template) |
равно не равно |
Укажите шаблон или шаблон для исключения. равно — событие относится к элементу данных / триггеру / правилу низкоуровневого обнаружения, унаследованному из указанного шаблона. не равно — событие не относится к элементу данных / триггеру / правилу низкоуровневого обнаружения, унаследованному из указанного шаблона. |
| Узел сети (Host) |
равно не равно |
Укажите узел сети или узел сети для исключения. равно — событие относится к указанному узлу сети. не равно — событие не относится к указанному узлу сети. |
Тип вычисления
Для вычисления условий доступны следующие опции:
- И (And) — должны быть выполнены все условия
Обратите внимание, вычисление «И» запрещено использовать между несколькими триггерами, когда они добавлены с условием Триггер равно. Действия могут выполняться на основе события только одного триггера.
- Или (Or) — достаточно выполнения одного условия
- И/Или (And/Or) — комбинация из двух опций: И с различными типами условий и ИЛИ с одинаковым типом условий, например:
Группа узлов сети равно Oracle сервера
Группа узлов сети равно MySQL сервера
Имя события содержит «База данных не работает»
Имя события содержит «База данных недоступна»
вычисляется как
(Группа узлов сети равно Oracle сервера или Группа узлов сети равно MySQL сервера) и (Имя события содержит «База данных не работает» или Имя события содержит «База данных недоступна»)
- Пользовательское выражение — формула вычисления, введенная пользователем, для оценки условий действия. Она должна включать в себя все условия (представленные в виде заглавных букв A, B, C, ...) и может включать пробелы, символы табуляции, скобки ( ), and (с учётом регистра), or (с учётом регистра), not (с учётом регистра).
Тогда как предыдущий пример с И/Или был бы представлен в виде (A or B) and (C or D), в пользовательском выражении вы также можете использовать несколько других методов вычисления:
(A and B) and (C or D)
(A and B) or (C and D)
((A or B) and C) or D
(not (A or B) and C) or not D
и так далее.
Удаление объектов, используемых в действиях
При попытке удалить объекты, которые используются в условии/операции действия, пользователь получит соответствующее сообщение об ошибке.
Действия не деактивируются, если условия или операции действия:
- имеют удалённые объекты;
- имеют объекты, которые более не обнаруживаются низкоуровневым обнаружением и были удалены (после периода Удаление потерянных ресурсов (Delete lost resources)).
Условия/операции действия не удаляются, если в них отсутствуют объекты. Вместо этого удалённые объекты отображаются как Удалённая группа узлов сети, Удалённый узел сети, Удалённый триггер и т. д. Значок предупреждения с сообщением: «Это действие имеет условия или операции, ссылающиеся на удалённые объекты (This action has conditions or operations referencing deleted object(s))», — отображается в столбце «Инфо (Info)» списка действий.
Обратите внимание, что до версии Zabbix 7.0.10, если определённый объект (узел сети, шаблон, триггер и т. д.), используемый в условии/операции действия, удаляется, то условие/операция удаляются, а действие деактивируется.