Integración con Prometheus

Prometheus con Alertmanager es una pila de monitoreo y alertas de código abierto muy utilizada. Al integrarlo con Echobell, recibirás notificaciones móviles instantáneas (incluidas de alta prioridad o en forma de llamada) cuando se activen tus reglas de alerta.

Requisitos previos

Una cuenta de Echobell con al menos un canal
Un entorno funcionando de Prometheus + Alertmanager
Acceso para editar la configuración de Alertmanager (alertmanager.yml)

Resumen de configuración

Crea un canal en Echobell
Configura las plantillas de notificación (y la Plantilla de Enlace opcional)
Elige un método de integración:
- Webhook mediante un receptor de webhook en Alertmanager (recomendado)
- Correo mediante un receptor de email en Alertmanager (alternativo)
Crea o actualiza reglas de alerta
Prueba y ajusta

Guía paso a paso

1) Crea un canal de Echobell

Abre la app Echobell
Crea un canal (por ejemplo, "Prometheus Alerts")
Elige un color para identificarlo fácilmente

2) Configura las plantillas

La carga útil del webhook de Alertmanager incluye campos como status, commonLabels, commonAnnotations, externalURL y una matriz alerts. Puedes referenciarlos directamente en las plantillas de Echobell.

Plantillas sugeridas:

Plantilla de título:

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

Plantilla de cuerpo:

🔔 Alerta: {{commonLabels.alertname}}
📊 Severidad: {{commonLabels.severity}}
🖥️ Instancia: {{alerts[0].labels["instance"]}}
⏰ Inicio: {{alerts[0].startsAt}}
ℹ️ Resumen: {{commonAnnotations.summary}}
🧾 Descripción: {{commonAnnotations.description}}

Plantilla de enlace (opcional):

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

Muestra un enlace directo al gráfico o panel relevante. Si no hay generatorURL, se usa externalURL.

3) Método A — Webhook (recomendado)

En tu canal de Echobell, copia la URL de Webhook desde Triggers
En Alertmanager, añade un receptor de webhook que publique a esa URL

Ejemplo mínimo de alertmanager.yml:

route:
  receiver: echobell-webhook
 
receivers:
  - name: echobell-webhook
    webhook_configs:
      - url: "https://hook.echobell.one/t/REPLACE_WITH_YOUR_TOKEN"
        send_resolved: true
        http_config:
          follow_redirects: true

Notas:

send_resolved: true también notificará cuando la alerta se resuelva
Echobell lee el JSON tal cual, por lo que las plantillas anteriores funcionarán

3 alt) Método B — Correo (alternativo)

Si prefieres/necesitas correo, usa el receptor de email de Alertmanager y envía a la dirección vinculada al canal.

En Echobell, copia la dirección de correo del canal desde Triggers
Configura un receptor de email en Alertmanager con plantillas simples

Ejemplo:

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

En las plantillas de Echobell para disparos por email, puedes usar variables como subject, text y html que la app proporciona automáticamente.

4) Regla de alerta de ejemplo

groups:
  - name: example
    rules:
      - alert: HighCPU
        expr: avg(rate(process_cpu_seconds_total[5m])) > 0.8
        for: 2m
        labels:
          severity: critical
        annotations:
          summary: "Uso alto de CPU"
          description: "La CPU superó 80% por 2 minutos"