Iniciar sesión Inicio Documentación de la API Agente Pantalla Compartir Privacidad Soporte
Get Shellward
aplicación para iPhone aplicación para Android agente para macOS (.dmg) Linux Windows GitHub

Inicio / Documentación / Alertmanager

Alertas de Alertmanager como notificaciones push en el iPhone

El receptor de webhook de Alertmanager puede hacer un POST a cualquier URL cuando se activa o se resuelve una alerta. Apúntalo a Shellward y tus alertas de Prometheus se convertirán en notificaciones push en el iPhone, con la etiqueta severity asignada a la prioridad de la notificación y las alertas agrupadas resumidas para ti.

La configuración del receptor

Añade un receptor de webhook a alertmanager.yml y dirige las alertas hacia él:

receivers:
  - name: pling
    webhook_configs:
      - url: "https://api.shellward.app/api/ingest/alertmanager/YOUR_TOKEN"
        send_resolved: true

route:
  receiver: pling

Recargar y probar

Recarga la configuración y luego envía una alerta de prueba:

curl -X POST http://localhost:9093/-/reload

Cómo se ve la notificación push

Where to get your token: create an API token in the Shellward app, or at shellward.app/account, and swap it into the URL above. Full API reference in the documentación.

Preguntas frecuentes

¿Funciona send_resolved?

Sí. Con send_resolved: true, Alertmanager también publica cuando una alerta se resuelve, y Shellward la entrega como una notificación [RESOLVED] de baja prioridad.

¿Qué ocurre con las alertas agrupadas?

Alertmanager agrupa las alertas antes de enviarlas. Shellward usa el nombre de alerta del grupo como título y en el mensaje indica cuántas alertas hay en el grupo.

¿Cómo se decide la prioridad?

Una etiqueta severity: critical se asigna a prioridad alta, otras severidades a normal, y las notificaciones resueltas a baja. La anotación de resumen y la etiqueta de instancia forman el mensaje.

¿Dónde obtengo mi token?

Crea un token de API en la app de Shellward o en shellward.app/account y úsalo en lugar de YOUR_TOKEN en la URL del webhook.

Más recetas: GitHub Actions, tareas cron, Python, Grafana, Uptime Kuma, referencia de la API