Настройка отправки уведомлений по SNMP

Чтобы задать параметры отправки уведомлений мониторинга по SNMP, отправьте POST-запрос к конечной точке API Визион:

https://<vision_host>:8092/vision/api/v1/config/snmp_notifier_config

В теле запроса передайте объект JSON со следующими полями:

snmp_authentication_password

Пароль аутентификации SNMP (только для V3).

Этот параметр обязателен, если задано значение параметра snmp_authentication_protocol.

Значение по умолчанию: null.
snmp_authentication_protocol

Протокол шифрования пароля (только для V3).

Допустимые значения:
- MD5;
- SHA;
- null.
Значение по умолчанию: null.
snmp_authentication_username

Имя пользователя аутентификации SNMP (только для V3).

Этот параметр обязателен, если задано значение параметра snmp_authentication_protocol.

Значение по умолчанию: null.
snmp_community

Коммьюнити SNMP (только для V2c, иначе null).

Значение по умолчанию: public.
snmp_context_engine_id

ID механизма контекста.

Значение по умолчанию: null.
snmp_context_name

Название контекста.

Значение по умолчанию: null.
snmp_destination

Адресат сообщений.

Значение по умолчанию 127.0.0.1:162.
snmp_private_password

Пароль шифрования SNMP (только для V3).

Этот параметр обязателен, если задано значение параметра snmp_private_protocol.

Значение по умолчанию: null.
snmp_private_protocol

Протокол передачи данных SNMP (только для V3).

Допустимые значения:
- AES;
- DES;
- null.
Значение по умолчанию: null.
snmp_retries

Ограничение количества попыток отправки сообщения SNMP.

Значение по умолчанию: 1.
snmp_security_engine_id

ID механизма безопасности SNMP.

Значение по умолчанию: null.
snmp_timeout_sec

Длительность таймаута в секундах.

Значение по умолчанию: 5.
snmp_trap_default_oid

OID ловушки, если он не найден в метках сработавшего правила.

Значение по умолчанию: 1.3.6.1.4.1.98789.
snmp_version

Версия SNMP.

Допустимые значения:
- V2c;
- V3.
Значение по умолчанию: V2c.

Пример запроса#

Рассмотрим пример запроса:

curl -k -X 'POST' \
     'https://<vision_host>:8088/vision/api/v1/config/snmp_notifier_config' \
     -H 'accept: application/json' \
     -H 'Content-Type: application/json' \
     -d '{
           "snmp_version": "V3",
           "snmp_destination": "127.0.0.1:162",
           "snmp_retries": 1,
           "snmp_trap_default_oid": "1.3.6.1.4.1.98789",
           "snmp_timeout_sec": 5,
           "snmp_authentication_protocol": "MD5",
           "snmp_authentication_username": "username",
           "snmp_authentication_password": "password",
           "snmp_private_protocol": "AES",
           "snmp_private_password": "password",
           "snmp_security_engine_id": "xxxxxxxxxx"
         }'

Здесь:

версия SNMP — V3;
адресат сообщений — служба на локальном узле (localhost), которая слушает порт 162;
на отправку сообщения даётся одна попытка;
используется OID 1.3.6.1.4.1.98789;
для защиты данных аутентификации используется протокол MD5;
для защиты передаваемых данных используется протокол AES.

Настройка перечня уведомлений, отправляемых по SNMP#

Авторизуйтесь в Визион.
На панели навигации выберите Настройки → Группы рассылки.
Нажмите кнопку Добавить и создайте новую группу рассылки.
Заполните форму с параметрами группы рассылки:
- Имя: название группы рассылки.
- Описание: подробное описание группы рассылки, например, «Группа поддержки 1 линии».
- Условия:
  - Метка: severity.
  - Оператор: =.
  - Значение:
    - чтобы получать уведомления обо всех событиях, выберите все возможные значения;
    - чтобы получать уведомления только о критичных событиях, выберите critical.
- Получатели: SNMP-шлюз.
Нажмите кнопку Добавить.