Documentation
Table of Contents
1. Настройка триггера
Обзор
Для настройки триггера сделайте следующее:
- Перейдите к: Сбор данных → Узлы сети (Data collection → Hosts)
- Нажмите на Триггеры (Triggers) в строке с узлом сети
- Нажмите на Создать триггер (Create trigger) сверху справа (или на имя триггера для изменения уже существующего триггера)
- Введите в диалоге параметры триггера
Смотрите также общую информацию о триггерах и их времени вычисления.
Настройка
Вкладка Триггер содержит все существенные атрибуты триггера.
Все обязательные поля ввода отмечены красной звёздочкой.
| Параметр | Описание |
|---|---|
| Имя (Name) |
Имя триггера. Поддерживаемые макросы: {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {ITEM.VALUE}, {ITEM.LASTVALUE}, {ITEM.LOG.*} и пользовательские макросы {$МАКРОС}. Можно использовать макросы $1, $2...$9, чтобы сослаться на первую, вторую...девятую константы из выражения. Обратите внимание: Макросы $1—$9 будут раскрыты корректно, если ссылаются на константы в относительно простых, понятных выражениях. Например, имя «Загрузка процессора превышает $1 на {HOST.NAME}» будет автоматически изменено на «Загрузка процессора превышает 5 на Новый узел сети», если выражение — last(/Новый узел сети/system.cpu.load[percpu,avg1])>5 |
| Имя события (Event name) |
Если указано, это имя будет использования для создания имени события о проблеме, вместо имени триггера. Имя события можно использовать для построения осмысленных оповещений, содержащих данные о проблеме (смотрите пример). Поддерживается тот же самый набор макросов, что и в имени триггера, плюс {TIME} и макросы выражений {?EXPRESSION}. |
| Оперативные данные (Operational data) |
Оперативные данные позволяют задать произвольные строки вместе с макросами. Эти макросы будут раскрываться динамически с соответствии с данными в реальном времени в Мониторинг → Проблемы. В то время как макросы в имени триггера (см. выше) раскроются в свои значения на момент наступления проблемы и станут основой статического имени проблемы, макросы в оперативных данных сохранят возможность отображения динамически самой последней информации. Если на уровне триггера не настроены никакие оперативные данные, будут отображены последние значения всех элементов данных из выражения. Поддерживается тот же самый набор макросов, что и в имени триггера. |
| Важность (Severity) | Задайте требуемую важность триггера нажатием кнопок. |
| Выражение проблемы (Expression) |
Логическое выражение, используемое для определения условий проблемы. Проблема создается после того, как все условия, включённые в выражение, удовлетворены, то есть результатом вычисления выражения является значение ИСТИНА. Проблема будет решена, как только результатом вычисления выражения будет значение ЛОЖЬ, если только в Выражении восстановления не указаны дополнительные условия восстановления. |
| Генерация ОК событий (OK event generation) |
Опции формирования ОК событий: Выражение (Expression) — ОК события формируются на основе того же выражения, что и события о проблемах; Выражение восстановления (Recovery expression) — OK события формируются, если выражение проблемы вычисляется как ЛОЖЬ и выражение восстановления вычисляется как ИСТИНА; Нет (None) — в этом случае триггер никогда самостоятельно не вернётся в состояние ОК. |
| Выражение восстановления (Recovery expression) |
Логическое выражение (опционально), определяющее дополнительные условия, которые должны быть удовлетворены для решения проблемы, после того, как исходное выражение проблемы уже вычислено как ЛОЖЬ. Выражение восстановления полезно для гистерезиса триггера. Возможность решения проблемы при помощи только выражения восстановления отсутствует, если выражение проблемы по-прежнему ИСТИНА. Это поле доступно, только если в поле Генерация ОК событий выбрано «Выражение восстановления». |
| Режим генерации событий ПРОБЛЕМА (PROBLEM event generation mode) |
Режим формирования событий о проблемах: Одиночный (Single) — формируется одно событие, когда триггер переходит в состояние «Проблема» в первый раз; Множественный (Multiple) — событие формируется на каждое вычисление триггера «Проблема». |
| ОК событие закрывает (OK event closes) |
Выберите, если ОК событие закрывает: Все проблемы (All problems) — все проблемы этого триггера Все проблемы, если значение тега совпадает (All problems if tag values match) — только те проблемы триггера, значения тегов событий которых совпадают |
| Теги для совпадения (Tag for matching) |
Укажите имя тега события, которое будет использоваться для корреляции событий. Это поле отображается, если в свойстве ОК событие закрывает выбрано «Все проблемы, если значения тегов совпадают», и в этом случае это поле обязательно. |
| Разрешить закрывать вручную (Allow manual close) |
Выберите, чтобы разрешить закрывать вручную события о проблемах, сформированные этим триггером. Закрытие вручную возможно при подтверждении событий о проблемах. |
| Имя пункта меню (Menu entry name) |
Если указать имя (не более 64 знаков), оно будет использоваться в нескольких местах веб-интерфейса в качестве подписи к URL триггера, заданному в параметре URL пункта меню. Если оставить пустым, будет использовано имя по умолчанию URL триггера. Поддерживается тот же набор макросов, что и в URL триггера. |
| URL пункта меню (Menu entry URL) |
Если указать URL (не более 2048 знаков), он будет доступен в виде ссылки в меню события в нескольких местах веб-интерфейса, например при нажатии на имя проблемы в Мониторинг → Проблемы или в виджете Проблемы на панели. Поддерживается тот же набор макросов, что и в имени триггера, плюс {EVENT.ID}, {HOST.ID} и {TRIGGER.ID}. Обратите внимание, что в URL не будут раскрыты пользовательские макросы со скрытыми значениями. |
| Описание (Description) |
Текстовое поле используется, чтобы предоставить больше информации об этом триггере. Может содержать инструкции по устранению специфичной проблемы, контактные данные ответственного сотрудника и т.п. Поддерживается тот же самый набор макросов, что и в имени триггера. |
| Активировано (Enabled) |
Уберите отметку, чтобы отключить триггер при необходимости. Проблемы по отключенным триггерам более не будут отображаться в веб-интерфейсе, но также и не будут удалены. |
На вкладке Теги (Tags) можно задать теги уровня триггера. Все проблемы этого триггера будут иметь теги со значениями, указанными здесь.
Кроме того, опция Унаследованные и собственные теги (Inherited and trigger tags) позволяет просмотреть теги, заданные на уровне шаблона, если триггер пришёл из этого шаблона. Если имеется несколько шаблонов с одинаковым тегом, эти теги отображаются однократно, а имена шаблонов перечисляются через запятую. Триггер не «наследует» и не отображает теги уровня узла сети.
| Параметр | Описание |
|---|---|
| Имя/Значение (Name/Value) |
Укажите пользовательские теги для маркировки событий триггера. Тег является парой из имени тега и значения. Вы можете использовать только имя или имя вместе со значением. У триггера может быть несколько тегов с одинаковым именем, но разными значениями. В тегах событий поддерживаются пользовательские макросы, пользовательские макросы с контекстом, макросы низкоуровневого обнаружения и функции макросов с {{ITEM.VALUE}}, {{ITEM.LASTVALUE}}, а также макросы низкоуровневого обнаружения. Макросы низкоуровневого обнаружения можно использовать внутри контекста макросов.Макрос {TRIGGER.ID} поддерживается в значениях тега триггеров. Он может быть полезным для идентификации триггеров, созданных из прототипов триггеров и, например, для подавления проблем от таких триггеров во время обслуживания. Если суммарная длина раскрытого значения превышает 255, значение будет обрезано до 255 символов. Смотрите все макросы, поддерживаемые для тегов событий. Теги событий можно использовать для корреляции событий, в условиях к действиям, также они видны в Мониторинг → Проблемы и в виджете Проблемы. |
Вкладка Зависимости (Dependencies) содержит все зависимости триггера.
Нажмите на Добавить (Add) для добавления новой зависимости.
Вы также можете настроить триггер, открыв уже существующий триггер, нажав на кнопку Клонировать (Clone), а затем сохранив уже новый триггер под другим именем.
Тестирование выражений
Имеется возможность проверки настроенного выражения триггера на предмет того, какой результат выражение будет иметь в зависимости от полученного значения.
В качестве примера взято следующее выражение из официального шаблона:
avg(/Cisco IOS SNMPv2/sensor.temp.value[ciscoEnvMonTemperatureValue.{#SNMPINDEX}],5m)>{$TEMP_WARN}
or
last(/Cisco IOS SNMPv2/sensor.temp.status[ciscoEnvMonTemperatureState.{#SNMPINDEX}])={$TEMP_WARN_STATUS}Для тестирования выражения нажмите на Конструктор выражения (Expression constructor) под полем выражения.
В Конструкторе выражения перечислены все отдельные выражения. Чтобы открыть окно тестирования, нажмите на Тест (Test) ниже списка выражений.
В окне тестирования вы можете задать пробные значения («80», «70», «0», «1» в этом примере) и затем увидеть результат выражения, нажав на кнопку Тест.
Можно увидеть результат как отдельных выражений, так и полного выражения.
Результат «ИСТИНА» означает, что введёное выражение верно. В этом конкретном выражении А, «80» больше чем указанное значение {$TEMP_WARN}, «70» в этом примере. Соответственно, появится результат «ИСТИНА».
Результат «ЛОЖЬ» означает, что введёное выражение неверно. В этом конкретном выражении B, {$TEMP_WARN_STATUS}, равное «1» в этом примере, должно быть равно указанному значению 0, и это неправда. Соответственно, появится результат «ЛОЖЬ».
Выбранным типом выражения является «ИЛИ». Если по крайней мере одно из заданных выражений (A или B в этом случае) будет ИСТИНА, общий результат будет также ИСТИНА. Что означает, что текущее значение превысило пороговое значение и возникнет Проблема.