Настройка каналов оповещений

Используйте канал оповещений для указания мест, куда будут отправляться уведомления. В них указывается, каким способом и куда именно доставлять сообщения.

Канал оповещений может иметь одно или несколько направлений доставки, называемых интеграциями. Уведомления отправляются в каждую интеграцию (email, telegram, mattermost ,webhook), связанную с каналом оповещений.

На вкладке «Каналы уведомлений» вы можете:

  • Добавлять, редактировать и просматривать каналы оповещений и интеграции.

  • Удалять каналы оповещений и интеграции и интеграции

Поддерживаемые интеграции для каналов оповещений

Для каждого типа интеграции в каналов оповещений предусмотрены свои параметры конфигурации и процесс настройки:

Параметры для конфигурационного файла

seed

Определяет путь до папки с seed-файлами (от корня проекта). Читаются все файлы с расширением .yaml в указанной директории.
Формат: seed: <путь_к_файлам>/*.yaml
Пример: seed: seed/*.yaml

fail_on_malformed_seed

Управляет обработкой ошибок в seed-файлах:

  • true – остановка программы при первой ошибке (например, неверный формат или отсутствие поля)

  • false – пропуск невалидных каналов оповещений с продолжением работы

Пример: fail_on_malformed_seed: true

delete_unchangeable_contact_points

Контролирует синхронизацию между seed-файлами и БД:

  • true – удаляет из БД каналы оповещений, отсутствующие в seed-файлах (с обновлением существующих)

  • false – добавляет новые и обновляет существующие каналы оповещений (без удаления)

Уникальность каналов оповещений определяется по имени. Каналы оповещений из seed-файлов создаются (если отсутствуют) или перезаписываются (если существуют).

Параметр изменяемости канала оповещений

changeable — флаг, который определяет, где можно изменять контактную точку.

  • changeable: true — канал редактируется через веб-интерфейс (UI); доступно редактирование и удаление.

  • changeable: false — канал только для просмотра в UI; редактирование и удаление возможны только через seed/infra (файлы, Terraform, CI или админские инструменты).

Создание seed-файлов:

Вам нужно разместить YAML-файлы в определённой директории, путь к которой указан в параметре seed вашего конфигурационного файла. Нельзя создавать вложенные папки внутри этой директории — все YAML-файлы должны лежать прямо в корне указанной папки.

Настройка каналов из seed-файла:

Каждый файл должен содержать один или несколько каналов оповещений:

- name: УникальноеИмяКанала
  changeable: true
  integrations:
  - type: "mattermost"
    channel:
      settings: ...

- name: УникальноеИмяКанала
  changeable: false
  integrations:
  - type: "mattermost"
    channel:
      settings: ...
  - type: "telegram"
    channel:
      settings: ...
  - type: "email"
    recipients: ["examlpe1@exe.ru", "examlpe2@exe.ru", ...]
  - type: "webhook"
    channel:
      settings: ...