Интеграция с Prometheus Alertmanager — мобильные оповещения

Создайте канал Echobell

1. Откройте приложение Echobell
2. Создайте новый канал (например, «Prometheus Alerts»)
3. Выберите цвет, чтобы канал было легко узнавать

Настройте шаблоны уведомлений

Payload вебхука Alertmanager содержит структурированные поля: status, commonLabels, commonAnnotations, externalURL и массив alerts. Эти поля можно напрямую использовать в шаблонах Echobell.

Рекомендуемые шаблоны:

Шаблон заголовка:

{{commonLabels.alertname}} - {{status}}

Шаблон тела:

🔔 Alert: {{commonLabels.alertname}}
📊 Severity: {{commonLabels.severity}}
🖥️ Instance: {{alerts[0].labels["instance"]}}
⏰ Starts: {{alerts[0].startsAt}}
ℹ️ Summary: {{commonAnnotations.summary}}
🧾 Description: {{commonAnnotations.description}}

Опциональный шаблон ссылки (в дополнительных настройках):

{{alerts[0].generatorURL || externalURL}}

Так в записи оповещения появится прямая ссылка на сработавший график или дашборд. Если generatorURL отсутствует, используется externalURL.

Способ интеграции A — вебхук (рекомендуется)

1. В канале Echobell скопируйте URL вебхука из раздела «Триггеры»
2. В Alertmanager добавьте webhook-получатель, который отправляет запросы на этот URL

Минимальный пример alertmanager.yml:

route:
  receiver: echobell-webhook

receivers:
  - name: echobell-webhook
    webhook_configs:
      - url: "https://hook.echobell.one/t/<channel-token>"
        send_resolved: true
        http_config:
          follow_redirects: true

Примечания:

• send_resolved: true отправит уведомление и тогда, когда оповещение будет закрыто (status станет resolved)
• Echobell читает тело JSON как есть, поэтому шаблоны выше отработают корректно

Способ интеграции B — email (альтернатива)

Если вам удобнее или необходимо использовать email, задействуйте email-получатель Alertmanager и отправляйте письма на email-адрес, привязанный к каналу.

1. В Echobell скопируйте email-адрес канала из раздела «Триггеры»
2. Настройте email-получатель в Alertmanager и используйте простые шаблоны

Пример фрагмента конфигурации:

receivers:
  - name: echobell-email
    email_configs:
      - to: "PASTE_CHANNEL_EMAIL_ADDRESS"
        send_resolved: true
        subject: "{{ .CommonLabels.alertname }} - {{ .Status }}"
        html: |
          <p><strong>Summary:</strong> {{ .CommonAnnotations.summary }}</p>
          <p>{{ .CommonAnnotations.description }}</p>
          <p>
            <a href='{{ (index .Alerts 0).GeneratorURL }}' target='_blank' rel='noopener'>Open in Prometheus</a>
          </p>

В шаблонах Echobell для email-триггеров доступны переменные subject, text и html — Echobell подставляет их автоматически.

Создайте пример правила оповещения

Небольшое правило для проверки всей цепочки:

groups:
  - name: example
    rules:
      - alert: HighCPU
        expr: avg(rate(process_cpu_seconds_total[5m])) > 0.8
        for: 2m
        labels:
          severity: critical
        annotations:
          summary: "High CPU usage"
          description: "CPU has been over 80% for 2 minutes"

Как только это оповещение сработает, Alertmanager отправит событие настроенному получателю, а Echobell уведомит подписчиков канала.