Обзор
Что такое интеграция, как её создать, где взять API key и адрес приёма алертов.
Integration (интеграция) — точка приёма алертов от одного источника мониторинга. Источник отправляет алерты на адрес с API-ключом интеграции, а она определяет команду, политику эскалации и правила важности для каждого пришедшего алерта.
Создавать и настраивать интеграции могут org_admin, org_owner и team_admin
команды.
Создание
Интеграцию нельзя создать без политики эскалации, поэтому сначала заведите команду и её политику эскалации.
Откройте форму
На странице команды перейдите на вкладку Integrations и нажмите Add Integration.
Заполните параметры
Укажите Name, выберите Type (Alertmanager, Grafana, Zabbix или
Generic Webhook), команду (Team) и Escalation Policy. Блок
Severity Mapping заполнится пресетом выбранного типа и для начала его
можно не трогать (подробнее в статье Настройка
важности). Тип после создания не
меняется.
Сохраните ключ
После создания откроется окно с API key и готовым адресом приёма (Alert ingestion URL). Скопируйте их и нажмите I've Copied the Key.
Ключ показывается только один раз. Позже карточка Alert ingestion на
странице интеграции покажет адрес с заглушкой <API_KEY> вместо ключа. Утерянный
ключ не восстановить, но можно выпустить новый (Regenerate Key). Старый при
этом сразу перестаёт приниматься.
Адрес приёма
| Type | Адрес |
|---|---|
Alertmanager, Grafana | https://api.incidentgarden.ru/api/v1/integrations/<API_KEY>/alerts |
Zabbix, Generic Webhook | https://api.incidentgarden.ru/api/v1/integrations/<API_KEY>/webhook |
Форматы тела запроса описаны в статье Формат payload.
Пауза и удаление
Deactivate в меню интеграции останавливает приём, а Activate возвращает её в работу с тем же ключом. Удаление необратимо и о его последствиях рассказывает статья Удаление интеграции.
Рецепты
- Источники: AlertManager, Grafana, Zabbix, webhook.
- Доставка уведомлений в Telegram через бота организации.
- Настройка важности и удаление интеграции.