Documentation
Table of Contents
6 Способы оповещения
Обзор
Способы оповещений экспортируются вместе со множеством связанных объектов и со связями с объектами.
Экспорт
Для экспорта способов оповещений сделайте следующее:
- Перейдите в: Администрирование → Способы оповещения
- Отметьте способы оповещения, которые нужно экспортировать
- Нажмите на Экспорт ниже списка
Выбранные способы оповещения экспортируются в локальный XML файл с именем по умолчанию zbx_export_mediatypes.xml.
Импорт
Для импорта способов оповещения сделайте следующее:
- Перейдите в: Администрирование → Способы оповещения
- Нажмите на Импорт справа
- Выберите импортируемый файл
- Отметьте необходимые опции в правилах импорта
- Нажмите на Импорт
После импорта в веб-интерфейсе отобразится сообщение об успехе или об ошибке.
Правила импорта:
| Правило | Описание |
|---|---|
| Обновить существующее | Существующие элементы будут обновлены данными взятыми с файла импорта. В противном случае они не будут обновляться. |
| Создать новое | Импорт добавит новые элементы, используя данные из файла импорта. В противном случае они не будут добавляться. |
| Удалить пропущенное | Импорт удалит существующие элементы, которые отсутствуют в файле импорта. В противном случае они не будут удаляться. |
Формат экспорта
<?xml version="1.0" encoding="UTF-8"?>
<zabbix_export>
<version>4.4</version>
<date>2019-10-24T06:44:38Z</date>
<media_types>
<media_type>
<name>Slack chat</name>
<type>WEBHOOK</type>
<parameters>
<parameter>
<name>channel</name>
<value>{ALERT.SENDTO}</value>
</parameter>
<parameter>
<name>text</name>
<value>{ALERT.MESSAGE}</value>
</parameter>
<parameter>
<name>username</name>
<value>bot</value>
</parameter>
</parameters>
<script>var req = new CurlHttpRequest();
req.AddHeader('Content-Type: application/x-www-form-urlencoded');
Zabbix.Log(127, 'webhook requqest value='+value);
req.Post('https://hooks.slack.com/services/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',
'payload='+value
);
Zabbix.Log(127, 'response code: '+req.Status());
return JSON.stringify({
'tags': {
'delivered': 'slack'
}
});</script>
<process_tags>YES</process_tags>
<event_menu_url>https://www.zabbix.com</event_menu_url>
<event_menu_name>Slack message</event_menu_name>
<description>Slack chat messages.</description>
</media_type>
</media_types>
</zabbix_export>Теги элементов
Значения тегов элементов описаны в таблице ниже.
| Элемент | Свойство элемента | Требуется | Тип | Диапазон1 | Описание |
|---|---|---|---|---|---|
| media_types | - | Корневой элемент способов оповещения. | |||
| media_type | - | Одиночный способо оповещения. | |||
| name | x | string |
Имя способа оповещения. | ||
| type | x | string |
0 - EMAIL 1 - SMS 2 - SCRIPT 4 - WEBHOOK |
Способ доставки, который используется способом оповещения. | |
| status | - | string |
0 - ENABLED (по умолчанию) 1 - DISABLED |
Активирован ли способ оповещения. | |
| max_sessions | - | integer |
Возможные значения для SMS: 1 - (по умолчанию) Возможные значения для других способов оповещения: 0-100, 0 - не ограничено |
Максимальное количество оповещений, которые могут быть обработаны одновременно. | |
| attempts | - | integer |
1-10 (по умолчанию: 3) | Максимальное количество попыток отправки оповещения. | |
| attempt_interval | - | string |
0-60s (по умолчанию: 10s) | Интервал между попытками. Принимает секунды и единицы времени с суффиксом. |
|
| description | - | string |
Описание способа оповещения. | ||
| Используется только e-mail способом оповещения | |||||
| smtp_server | x | string |
SMTP сервер. | ||
| smtp_port | - | integer |
По умолчанию: 25 | Порт SMTP сервера, к которому необходимо подключаться. | |
| smtp_helo | x | string |
SMTP helo. | ||
| smtp_email | x | string |
Email адрес от которого будут отправляться оповещения. | ||
| smtp_security | - | string |
0 - NONE (по умолчанию) 1 - STARTTLS 2 - SSL_OR_TLS |
Используемый уровень безопасности SMTP соединения. | |
| smtp_verify_host | - | string |
0 - NO (по умолчанию) 1 - YES |
Проверка SSL узла для SMTP. Опционально, если smtp_security равно значениям STARTTLS или SSL_OR_TLS. | |
| smtp_verify_peer | - | string |
0 - NO (по умолчанию) 1 - YES |
Проверка SSL хоста для SMTP. Опционально, если smtp_security равно значениям STARTTLS или SSL_OR_TLS. | |
| smtp_authentication | - | string |
0 - NONE (по умолчанию) 1 - PASSWORD |
Используемый метод SMTP аутентификации. | |
| username | - | string |
Имя пользователя. | ||
| password | - | string |
Пароль аутентификации. | ||
| content_type | - | string |
0 - TEXT 1 - HTML (по умолчанию) |
Формат сообщения. | |
| Используется только SMS способом оповещения | |||||
| gsm_modem | x | string |
Имя серийного устройства GSM модема. | ||
| Используется только способом оповещения скрипт | |||||
| script name | x | string |
Имя скрипта. | ||
| parameters | - | Корневой элемент параметров скрипта. | |||
| parameter | - | Одиночный параметр скрипта. | |||
| Используется только webhook способом оповещения | |||||
| script | x | string |
Скрипт. | ||
| timeout | - | string |
1-60s (по умолчанию: 30s) | Время ожидания выполнения HTTP запроса Javascript скриптом. | |
| process_tags | - | string |
0 - NO (по умолчанию) 1 - YES |
Обрабатывать ли полученные теги. | |
| show_event_menu | - | string |
0 - NO (по умолчанию) 1 - YES |
Если {EVENT.TAGS.*} успешно раскрыт в полях event_menu_url и event_menu_name, это поле указывает на наличие записи в меню события. | |
| event_menu_url | - | string |
Запись о URL меню события. Поддерживает {EVENT.TAGS.*} макросы. | ||
| event_menu_name | - | string |
Запись об имени меню события. Поддерживает {EVENT.TAGS.*} макросы. | ||
| parameters | - | Корневой элемент параметров webhook способа оповещения. | |||
| parameter | - | Одиночный параметр webhook способа оповещения. | |||
| name | x | string |
Имя webhook параметра. | ||
| value | - | string |
Значение webhook параметра. | ||
Примечания
1 Для строковых значений будут экспортированы только строки (такие как, "EMAIL"), без использованной в таблице нумерации. Числа со значениями диапазонов (в соответствии с API значениями) в этой таблице используются только для упорядочивания перечисления.