6 Способы оповещения

Обзор

Типы оповещений экспортируются вместе со всеми связанными объектами и связями между объектами.

Экспорт

Чтобы экспортировать типы медиа, выполните следующие действия:

1. Перейдите в Оповещения → Типы медиа.
2. Установите флажки у типов медиа, которые нужно экспортировать.
3. Нажмите Экспорт под списком.

В зависимости от выбранного формата типы медиа экспортируются в локальный файл с именем по умолчанию:

• zabbix_export_mediatypes.yaml — при экспорте в YAML (вариант по умолчанию для экспорта);
• zabbix_export_mediatypes.xml — при экспорте в XML;
• zabbix_export_mediatypes.json — при экспорте в JSON.

Импорт

Чтобы импортировать способы оповещения, выполните следующие действия:

1. Перейдите в Оповещения → Способы оповещения.
2. Нажмите Импортировать в правом верхнем углу.
3. Выберите файл импорта.
4. Отметьте необходимые параметры в правилах импорта.
5. Нажмите Импортировать в правом нижнем углу формы настройки.

Правила импорта:

Сообщение об успешном или неуспешном импорте будет отображено в веб-интерфейсе.

Формат экспорта

Экспорт в YAML:

zabbix_export:
  version: '8.0'
  media_types:
    - name: Pushover
      type: WEBHOOK
      parameters:
        - name: endpoint
          value: 'https://api.pushover.net/1/messages.json'
        - name: eventid
          value: '{EVENT.ID}'
        - name: event_nseverity
          value: '{EVENT.NSEVERITY}'
        - name: event_source
          value: '{EVENT.SOURCE}'
        - name: event_value
          value: '{EVENT.VALUE}'
        - name: expire
          value: '1200'
        - name: message
          value: '{ALERT.MESSAGE}'
        - name: priority_average
          value: '0'
        - name: priority_default
          value: '0'
        - name: priority_disaster
          value: '0'
        - name: priority_high
          value: '0'
        - name: priority_information
          value: '0'
        - name: priority_not_classified
          value: '0'
        - name: priority_warning
          value: '0'
        - name: retry
          value: '60'
        - name: title
          value: '{ALERT.SUBJECT}'
        - name: token
          value: '<PUSHOVER TOKEN HERE>'
        - name: triggerid
          value: '{TRIGGER.ID}'
        - name: url
          value: '{$ZABBIX.URL}'
        - name: url_title
          value: Zabbix
        - name: user
          value: '{ALERT.SENDTO}'
      status: DISABLED
      max_sessions: '0'
      script: |
        try {
            var params = JSON.parse(value),
                request = new HttpRequest(),
                data,
                response,
                severities = [
                    {name: 'not_classified', color: '#97AAB3'},
                    {name: 'information', color: '#7499FF'},
                    {name: 'warning', color: '#FFC859'},
                    {name: 'average', color: '#FFA059'},
                    {name: 'high', color: '#E97659'},
                    {name: 'disaster', color: '#E45959'},
                    {name: 'resolved', color: '#009900'},
                    {name: 'default', color: '#000000'}
                ],
                priority;

            if (typeof params.HTTPProxy === 'string' && params.HTTPProxy.trim() !== '') {
                request.setProxy(params.HTTPProxy);
            }

            if ([0, 1, 2, 3].indexOf(parseInt(params.event_source)) === -1) {
                throw 'Incorrect "event_source" parameter given: "' + params.event_source + '".\nMust be 0-3.';
            }

            if (params.event_value !== '0' && params.event_value !== '1'
                && (params.event_source === '0' || params.event_source === '3')) {
                throw 'Incorrect "event_value" parameter given: ' + params.event_value + '\nMust be 0 or 1.';
            }

            if ([0, 1, 2, 3, 4, 5].indexOf(parseInt(params.event_nseverity)) === -1) {
                params.event_nseverity = '7';
            }

            if (params.event_value === '0') {
                params.event_nseverity = '6';
            }

            priority = params['priority_' + severities[params.event_nseverity].name] || params.priority_default;

            if (isNaN(priority) || priority < -2 || priority > 2) {
                throw '"priority" should be -2..2';
            }

            if (params.event_source === '0' && isNaN(params.triggerid)) {
                throw 'field "triggerid" is not a number';
            }

            if (isNaN(params.eventid)) {
                throw 'field "eventid" is not a number';
            }

            if (typeof params.message !== 'string' || params.message.trim() === '') {
                throw 'field "message" cannot be empty';
            }

            data = {
                token: params.token,
                user: params.user,
                title: params.title,
                message: params.message,
                url: (params.event_source === '0') 
                    ? params.url + '/tr_events.php?triggerid=' + params.triggerid + '&eventid=' + params.eventid
                    : params.url,
                url_title: params.url_title,
                priority: priority
            };

            if (priority == 2) {
                if (isNaN(params.retry) || params.retry < 30) {
                    throw 'field "retry" should be a number with value of at least 30 if "priority" is set to 2';
                }

                if (isNaN(params.expire) || params.expire > 10800) {
                    throw 'field "expire" should be a number with value of at most 10800 if "priority" is set to 2';
                }

                data.retry = params.retry;
                data.expire = params.expire;
            }

            data = JSON.stringify(data);
            Zabbix.log(4, '[ Pushover Webhook ] Sending request: ' + params.endpoint + '\n' + data);

            request.addHeader('Content-Type: application/json');
            response = request.post(params.endpoint, data);

            Zabbix.log(4, '[ Pushover Webhook ] Received response with status code ' + request.getStatus() + '\n' + response);

            if (response !== null) {
                try {
                    response = JSON.parse(response);
                }
                catch (error) {
                    Zabbix.log(4, '[ Pushover Webhook ] Failed to parse response received from Pushover');
                    response = null;
                }
            }

            if (request.getStatus() != 200 || response === null || typeof response !== 'object' || response.status !== 1) {
                if (response !== null && typeof response === 'object' && typeof response.errors === 'object'
                        && typeof response.errors[0] === 'string') {
                    throw response.errors[0];
                }
                else {
                    throw 'Unknown error. Check debug log for more information.';
                }
            }

            return 'OK';
        }
        catch (error) {
            Zabbix.log(4, '[ Pushover Webhook ] Pushover notification failed: ' + error);
            throw 'Pushover notification failed: ' + error;
        }
      description: |
        Пожалуйста, обратитесь к руководству по настройке здесь: https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pushover

        Установите параметр token в значение ключа вашего приложения Pushover.
        При назначении медиа Pushover пользователю Zabbix — добавьте ключ пользователя в поле send to.
      message_templates:
        - event_source: TRIGGERS
          operation_mode: PROBLEM
          subject: 'Проблема: {EVENT.NAME}'
          message: |
            Проблема возникла в {EVENT.TIME} {EVENT.DATE}
            Имя проблемы: {EVENT.NAME}
            Узел сети: {HOST.NAME}
            Важность: {EVENT.SEVERITY}
            Операционные данные: {EVENT.OPDATA}
            ID исходной проблемы: {EVENT.ID}
            {TRIGGER.URL}
        - event_source: TRIGGERS
          operation_mode: RECOVERY
          subject: 'Устранено за {EVENT.DURATION}: {EVENT.NAME}'
          message: |
            Проблема была устранена в {EVENT.RECOVERY.TIME} {EVENT.RECOVERY.DATE}
            Имя проблемы: {EVENT.NAME}
            Длительность проблемы: {EVENT.DURATION}
            Узел сети: {HOST.NAME}
            Важность: {EVENT.SEVERITY}
            ID исходной проблемы: {EVENT.ID}
            {TRIGGER.URL}
        - event_source: TRIGGERS
          operation_mode: UPDATE
          subject: 'Проблема обновлена через {EVENT.AGE}: {EVENT.NAME}'
          message: |
            {USER.FULLNAME} {EVENT.UPDATE.ACTION} проблему {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME}.
            {EVENT.UPDATE.MESSAGE}

            Текущее состояние проблемы: {EVENT.STATUS}, возраст: {EVENT.AGE}, подтверждена: {EVENT.ACK.STATUS}.
        - event_source: DISCOVERY
          operation_mode: PROBLEM
          subject: 'Обнаружение: {DISCOVERY.DEVICE.STATUS} {DISCOVERY.DEVICE.IPADDRESS}'
          message: |
            Правило обнаружения: {DISCOVERY.RULE.NAME}

            IP устройства: {DISCOVERY.DEVICE.IPADDRESS}
            DNS устройства: {DISCOVERY.DEVICE.DNS}
            Состояние устройства: {DISCOVERY.DEVICE.STATUS}
            Время работы устройства: {DISCOVERY.DEVICE.UPTIME}

            Имя сервиса устройства: {DISCOVERY.SERVICE.NAME}
            Порт сервиса устройства: {DISCOVERY.SERVICE.PORT}
            Состояние сервиса устройства: {DISCOVERY.SERVICE.STATUS}
            Время работы сервиса устройства: {DISCOVERY.SERVICE.UPTIME}
        - event_source: AUTOREGISTRATION
          operation_mode: PROBLEM
          subject: 'Авторегистрация: {HOST.HOST}'
          message: |
            Имя узла сети: {HOST.HOST}
            IP узла сети: {HOST.IP}
            Порт агента: {HOST.PORT}

Экспортируемые элементы

Экспортируемые элементы описаны в таблице ниже.

Email

Следующие дополнительные элементы экспортируются только для типа медиа Email.

SMS

Следующие дополнительные элементы экспортируются только для типа медиа SMS.

Скрипт

Следующие дополнительные элементы экспортируются только для типа медиа Скрипт.

Вебхук

Следующие дополнительные элементы экспортируются только для типа медиа Вебхук.

Сноски

¹ Значения API типа integer в скобках, например ENABLED (0), указаны только для справки. Для получения дополнительной информации смотрите связанную страницу объекта API в записи таблицы или в конце каждого раздела.