Инциденты — Настройка

Подключение алертов Grafana

Для работы инцидентов коллектор GMONIT должен получать алерты из Grafana. Это требует настройки подключения коллектора к Grafana.

Коллектор получает алерты через Grafana Annotations API. Задайте переменные окружения коллектора:

Переменная	Описание	Пример
`GRAFANA_API_URL`	URL к Grafana API	`http://grafana:3000/api`
`GRAFANA_API_AUTHORIZATION`	Заголовок авторизации	`Bearer glsa_xxxxxxxxxxxx`

Дополнительные параметры детектирования:

Переменная	Описание	По умолчанию
`INCIDENT_MANAGER_DETECT_TIME_WINDOW_MINUTE`	Временное окно детектирования (мин)	`30`
`INCIDENT_MANAGER_DETECT_TIME_WINDOW_SHIFT`	Сдвиг окна назад от момента алерта (мин)	`15`

Для получения GRAFANA_API_AUTHORIZATION:

Откройте Grafana → Administration → Service accounts
Создайте сервисный аккаунт с ролью Viewer
Сгенерируйте токен
Укажите значение в формате Bearer <токен>

Статический движок корреляции

Статический движок ([GMONIT] Unified anomaly grouping) включён по умолчанию и не требует дополнительных сервисов. При необходимости можно настроить его параметры через переменные окружения коллектора.

Переменная	Описание	По умолчанию
`ANOMALY_CORRELATION_STATIC_ENGINE_ENABLED`	Включить статический движок	`true`
`UNIFIED_ENGINE_MAX_INTERVAL_MINUTE`	Макс. интервал между алертами/выбросами для группировки (мин)	`10`
`UNIFIED_ENGINE_BFS_DEPTH`	Глубина обхода графа связности сервисов	`0`
`UNIFIED_ENGINE_TOP_OUTLIERS`	Кол-во самых сильных выбросов, используемых как ядро корреляции инцидента	`20`

ML-движок корреляции

Для использования ML-алгоритма корреляции необходимо развернуть дополнительный сервис, который выполняет ML-логику.

ML-движок — отдельный сервис, который разворачивается рядом с коллектором. Для развёртывания обратитесь в поддержку GMONIT — мы поможем с установкой и настройкой под вашу инфраструктуру.

После развёртывания ML-сервиса задайте переменные окружения коллектора:

Переменная	Описание
`ANOMALY_CORRELATION_ML_ENGINE_ENABLED`	`true` — включить ML-движок
`ANOMALY_CORRELATION_API_URL`	URL развёрнутого ML-сервиса (например, `http://anomaly-correlation-ml-service`)
`ANOMALY_CORRELATION_API_AUTHORIZATION`	Заголовок авторизации, если настроен на ML-сервисе