Документация Grafana Документация GlaberGraph Оповещения Настройка уведомлений Настройка точек контакта

Настройка точек контакта

Используйте точки контакта, чтобы указать, где получать уведомления об оповещениях. Точки контакта содержат конфигурацию для отправки уведомлений об оповещениях, включая места назначения, такие как электронная почта, Slack, IRM, webhooks, и их уведомительные сообщения.

Точка контакта может иметь одно или несколько мест назначения, известных как интеграции точки контакта. Уведомления об оповещениях отправляются в каждую интеграцию в пределах выбранной точки контакта.

На вкладке Contact Points вы можете:

• Добавлять, редактировать и просматривать точки контакта и интеграции.
• Искать по имени и типу точек контакта и интеграций.
• Видеть, для скольких политик уведомлений используется каждая точка контакта, и переходить напрямую к связанным политикам уведомлений.
• Просматривать статус доставки уведомлений.
• Экспортировать отдельные точки контакта или все точки контакта в формате JSON, YAML или Terraform.
• Удалять точки контакта. Обратите внимание, что нельзя удалить точки контакта, используемые политикой уведомлений. Чтобы продолжить, либо удалите политику уведомлений, либо обновите её для использования другой точки контакта.

Защищённые поля

Для пользователей Grafana точки контакта могут содержать защищённые поля, для изменения которых требуются права администратора. Защищённые поля — это чувствительные настройки конфигурации, влияющие на то, куда отправляются уведомления, например:

• Целевые URL для интеграций (webhooks, PagerDuty, Opsgenie или другие интеграции).
• Конечные точки API.
• Другие настройки, связанные с местом назначения.

Эти поля защищены, чтобы неавторизованные пользователи не могли перенаправить уведомления на скомпрометированные серверы, что могло бы раскрыть чувствительную информацию, такую как токены авторизации, ключи API или данные оповещений.

Пользователи с правами на редактирование могут изменять большинство настроек точки контакта и могут добавлять или удалять интеграции, но не могут изменять защищённые поля в существующих интеграциях. Только пользователи с правами администратора для точки контакта могут обновлять защищённые поля.

Возможность изменять защищённые поля контролируется действием RBAC alert.notifications.receivers.protected:write. Эта роль по умолчанию предоставляется:

• Пользователям с фиксированной ролью “Alerting Admin”
• Пользователям с правами администратора для конкретной точки контакта

Поддерживаемые интеграции точек контакта

Каждая интеграция точки контакта имеет свои параметры конфигурации и процесс настройки. Следующий список показывает интеграции точек контакта, поддерживаемые Grafana.

Некоторые из перечисленных интеграций не поддерживаются Prometheus Alertmanager. Список поддерживаемых интеграций см. в разделе настроек получателя Prometheus Alertmanager.

Добавление точки контакта

Выполните следующие шаги, чтобы добавить точку контакта.

1. В меню слева нажмите Alerts & IRM, а затем Alerting.
2. Нажмите Notification configuration, затем выберите вкладку Contact points.
3. В выпадающем списке Choose Alertmanager выберите Alertmanager. По умолчанию выбран Grafana Alertmanager.
4. Нажмите + New contact point.
5. Введите описательное имя точки контакта.
6. В Integration выберите тип и заполните обязательные поля. Например, если вы выбрали email, введите адреса электронной почты. Или, если вы выбрали Slack, введите канал Slack и пользователей, которых следует уведомить.
7. Некоторые интеграции точек контакта, такие как email или Webhook, имеют необязательные настройки. В Optional settings укажите дополнительные настройки для выбранной интеграции точки контакта.
8. В Notification settings при необходимости выберите Disable resolved message, если вы не хотите получать уведомления при разрешении оповещения.
9. Сохраните изменения.

Добавление ещё одной интеграции точки контакта

Точка контакта может иметь несколько интеграций, или мест назначения для отправки уведомлений.

Чтобы добавить ещё одну интеграцию в точку контакта, выполните следующие шаги.

1. Добавьте или отредактируйте существующую точку контакта.
2. Нажмите Add contact point integration и повторите те же шаги, что и в разделе Добавление точки контакта.
   • В Integration выберите тип и заполните обязательные поля.
   • В Optional settings укажите дополнительные настройки для выбранной интеграции точки контакта.
3. Сохраните изменения.

Настройка уведомительных сообщений

В точках контакта вы также можете настраивать уведомительные сообщения. Например, при настройке интеграции точки контакта email нажмите Message или Subject, чтобы изменить их.

По умолчанию уведомительные сообщения включают общие сведения об оповещении, которые обычно достаточны для большинства случаев.

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

На вкладке Templates под Notification configuration вы можете просматривать, редактировать, копировать или удалять шаблоны уведомлений. Инструкции по выбору или созданию шаблона для точки контакта см. в разделе управление шаблонами уведомлений.

Тестирование точки контакта

Тестирование точки контакта доступно только для Grafana Alertmanager. Выполните следующие шаги, чтобы протестировать точку контакта.

1. В меню слева нажмите Alerts & IRM, а затем Alerting.
2. Нажмите Notification configuration, затем выберите вкладку Contact points, чтобы увидеть список существующих точек контакта.
3. Найдите точку контакта, которую хотите протестировать, затем нажмите Edit. При необходимости вы также можете создать новую точку контакта.
4. Нажмите Test, чтобы открыть диалоговое окно тестирования точки контакта.
5. Выберите, отправить предопределённое тестовое уведомление или выбрать custom, чтобы добавить свои пользовательские аннотации и метки в уведомление.
6. Нажмите Send test notification, чтобы запустить оповещение.

Включение уведомлений для точки контакта

После создания точки контакта вы можете включить её для получения уведомлений об оповещениях одним из следующих способов:

• Назначить её правилам оповещений — выберите точку контакта в параметрах уведомлений для Grafana-managed правил оповещений, чтобы напрямую связать её с конкретными оповещениями.
• Назначить её политикам уведомлений — добавьте точку контакта в одну или несколько политик уведомлений, которые управляют уведомлениями об оповещениях, которые должна получать точка контакта.

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

Вкладка Contact points показывает статус последних доставок уведомлений для каждой точки контакта. Чтобы просмотреть прошлые попытки доставки и фильтровать по точке контакта или результату доставки, обратитесь к разделу Просмотр истории уведомлений.