Настройка интеграции с Admin Assistant#

Проблематика#

Admin Assistant обрабатывает события и уведомления, поступающие из систем мониторинга.

Предусловия#

Сценарии, не предполагающие использование специальных ролей, выполняются от имени роли администратора.

Правила эксплуатации#

GRAF используется с типом метрик Victortia Metric и с типом DataSource Prometheus. Интеграции с другими типами DataSource для приложения Admin Assistant не поддерживаются.

Последовательность выполнения#

Для настройки интеграции GRAF с Admin Assistant нужно воспользоваться меню Alerting и выполнить следующие действия:

  • создать Alerts Rule, которые будут определять отклонения в системе, требующие отправки уведомления

  • настроить Contact Point (тип Webhook)

Работа c Alerts Rule#

Поля формы Search by data sources, Dashboard, State, Rule type, Health, Contact point позволяют отфильтровать правила.

administration-scenarios-admin-assistant-alerts-rule.png

Редактирование/Создание#

В меню Alert rules можно создать/отредактировать правила отклонения и алерты - условия срабатывания и способы отправки уведомлений. Для создания правила нужно воспользоваться кнопкой + New alert rule.

administration-scenarios-admin-assistant-new-alert-rule.png

Для редактирования правила необходимо щелкнуть по нему мышью - откроется окно редактирования. Поддерживаются только DataSource типа Prometheus.

administration-scenarios-admin-assistant-edit-alert-rule.png

В качестве источника данных использует DataSource типа Prometheus.

administration-scenarios-admin-assistant-edit-prometheus.png

Сохранить созданное/отредактированное правило можно с помощью кнопок Save rule или Save rule and exit - правило выгружается в Admin Assistant при включенной интеграции (как включить/выключить интеграцию, см. выше в п.Пререквизиты).

Удаление#

Для удаления правила нужно нажать кнопку Delete и подтвердить действие

administration-scenarios-admin-assistant-delete.png

Contact Point#

Для создания Contact Point нужно нажать кнопку + Create contact point.

administration-scenarios-admin-assistant-contact-point.png

В окне Contact point нужно задать способ отправки уведомлений - Webhook (интеграция с внешними системами). Здесь указывается, куда уходить алертам, то есть адрес Admin Assistant.

  • выбран способ отправки «Webhook» - в нем указан адрес Admin Assistant.

administration-scenarios-admin-assistant-webhook.png

Результат#

После выполнения всех шагов по настройке интеграции GRAF с Admin Assistant достигаются следующие результаты:

  • Активирована передача алертов в Admin Assistant.

  • Обеспечена централизованная обработка событий.

  • Обеспечена обратная связь и управление алертами.

  • Обеспечена надежность доставки уведомлений.

Описание механизмов безопасности#

Для обеспечения безопасной и защищенной интеграции GRAF с Admin Assistant применяются следующие механизмы:

  1. Шифрование канала связи (TLS 1.2+):

  • Все HTTP-запросы между GRAF и Admin Assistant передаются по защищенному протоколу HTTPS.

  • Используются сертификаты, выпущенные доверенным УЦ.

  • Сертификаты хранятся в SecMan и подтягиваются через механизм __$secman{...}.

  • Проверка цепочки сертификатов и имени хоста (SAN) выполняется на обоих концах соединения.