Первый тестовый алерт

Отправьте тестовый алерт через curl и проверьте, что всё работает.

На последнем шаге вы отправите тестовый алерт через curl и убедитесь, что цепочка «интеграция → политика эскалации → расписание → уведомление» работает. Канал уведомлений на email аккаунта уже создан и подтверждён, так что письмо придёт без дополнительной настройки.

Откройте терминал

Подготовьте curl и API key интеграции, скопированный на предыдущем шаге.

Отправьте тестовый запрос в формате AlertManager

Подставьте свой <API_KEY> и выполните команду. Тело повторяет форму, в которой Alertmanager отправляет группу алертов:

curl -X POST https://api.incidentgarden.ru/api/v1/integrations/<API_KEY>/alerts \
  -H "Content-Type: application/json" \
  -d '{
    "status": "firing",
    "groupLabels": {
      "alertname": "TestAlert"
    },
    "commonLabels": {
      "alertname": "TestAlert",
      "severity": "critical",
      "service": "test"
    },
    "commonAnnotations": {
      "summary": "Test alert from quick start"
    },
    "alerts": [
      {
        "status": "firing",
        "labels": {
          "alertname": "TestAlert",
          "severity": "critical",
          "service": "test"
        },
        "annotations": {
          "summary": "Test alert from quick start"
        }
      }
    ]
  }'

Ответ HTTP 202 Accepted означает, что Incident Garden принял алерт в обработку.

Не сокращайте тело до одного alerts[]: заголовок, лейблы и важность Incident Garden берёт из groupLabels, commonLabels и commonAnnotations (почему так, объясняет гайд Подключение AlertManager).

Проверьте алерт в интерфейсе

Откройте раздел Alerts и в списке появится новый алерт. На его вкладке Payload видны лейблы alertname, severity, service и аннотация summary. Политика эскалации тем временем позовёт дежурного по вашему расписанию.

Дождитесь уведомления

Через несколько секунд на email аккаунта придёт письмо о тестовом алерте.

Вариант для generic webhook

Для интеграции типа Generic Webhook или Zabbix адрес другой, а тело короче:

curl -X POST https://api.incidentgarden.ru/api/v1/integrations/<API_KEY>/webhook \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Test alert from quick start",
    "description": "Verifying webhook ingestion",
    "labels": {
      "service": "test",
      "severity": "warning"
    }
  }'

Если письмо не пришло, проверьте, что вы участник ротации на текущий период и что email при регистрации подтверждён.

Quick Start пройден. Дальше стоит заглянуть в Anti-Patterns: там собраны типичные ошибки настройки.

На этой странице