# Haz que las alertas de Grafana llegan a tu teléfono.

> Recibe las alertas de Grafana como notificaciones push. Añade Pocket Alert como punto de contacto webhook y recibe las reglas de alerta activas en tu teléfono en menos de un segundo.

<!-- source: https://pocketalert.app/es/use-cases/grafana-alerts -->

Última actualización: 2026-08-11

Cuando se activa una regla de alerta de Grafana, el nombre, la gravedad y el estado de la alerta llegan a tu teléfono en menos de un segundo. Detecta los problemas antes de que el panel se ponga en rojo, sin tener una pantalla abierta.

## Tres pasos para tener las alertas de Grafana en tu teléfono

1. **Crea un webhook** — Crea un webhook de Pocket Alert con una plantilla de mensaje GJSON y copia su URL de recepción.
2. **Configura el punto de contacto** — Añade la URL como punto de contacto de tipo Webhook en Alerting de Grafana y asígnalo a una política de notificación.
3. **Mapea y envía** — GJSON mapea status, alertname, severity y el summary en tu notificación push. La siguiente alerta en disparo hará vibrar tu teléfono.

## Del panel en alerta a la pantalla de bloqueo

Grafana ya envía un webhook cuando se activa una regla de alerta. Pocket Alert lo convierte en una notificación push que no puedes pasar por alto.

- **Un punto de contacto estándar** — Añade Pocket Alert como punto de contacto de tipo Webhook en Alerting de Grafana. Sin plugin ni agente, funciona en Cloud y autoalojado.
- **Mapea campos con GJSON** — Las rutas GJSON extraen alertname, status y la anotación summary directamente del payload de Grafana y los llevan a tu notificación.
- **Gravedad y estado en línea** — Muestra la etiqueta de gravedad y el estado firing/resolved en la propia notificación push para que una alerta crítica se distinga de una recuperación.
- **Un canal por equipo** — Cada aplicación tiene su propia URL de webhook, así que las alertas de infraestructura, de aplicaciones y por equipo se mantienen en canales separados.
- **Entrega en menos de un segundo** — La alerta en disparo llega a tu teléfono en menos de un segundo, mucho antes de que alguien abra el panel.
- **URL de webhook secreta** — La URL del webhook es el secreto de tu aplicación sobre HTTPS. Renuévala cuando necesites un endpoint nuevo.

## Envía alertas de Grafana a tu teléfono

### 1. Crea un webhook de Pocket Alert

En la página [Webhooks](https://pocketalert.app/es/webhooks) crea un webhook cuya plantilla GJSON `message` lea el payload de Grafana. Grafana envía `status`, un bloque `commonLabels` y un array `alerts`, así que una plantilla válida es:

```
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Grafana","default_level":"critical","message":"[%status%] %commonLabels.alertname% (%commonLabels.severity%)\n%alerts.0.annotations.summary%","application_id":"qm47b9pzxzxg"}'
```

Obtendrás una URL de entrada como `https://p4a.me/wh/1234abcd`.

### 2. Añádelo como punto de contacto de tipo Webhook

En Grafana ve a [Alerting → Contact points → Add contact point](https://grafana.com/docs/grafana/latest/alerting/configure-notifications/manage-contact-points/integrations/webhook-notifier/), elige la integración Webhook y pega la URL de recepción:

```
Integration: Webhook
URL:    https://p4a.me/wh/1234abcd
Method: POST
```

Asigna el punto de contacto a una política de notificación para que las alertas coincidentes lleguen a él. Grafana envía su JSON estándar; las rutas GJSON de arriba extraen `status`, `commonLabels.alertname`, `commonLabels.severity` y `alerts.0.annotations.summary` en la notificación push.

### 3. Haz una prueba

Usa el botón Test del punto de contacto. Una alerta en disparo llega como `[firing] HighCPU (critical)`; cuando se resuelve, `status` cambia a `resolved`.

La [documentación de ajustes de webhooks](https://info.pocketalert.app/api/webhooks/settings.html) explica todas las rutas GJSON y opciones de webhook.

## Preguntas frecuentes

### ¿Cómo envío alertas de Grafana a mi teléfono?

En Grafana ve a Alerting → Contact points, añade un punto de contacto de tipo Webhook y pega la URL de tu aplicación de Pocket Alert. Asígnalo a una política de notificación y la siguiente alerta en disparo llegará a tu teléfono en menos de un segundo.

### ¿Cómo funciona el mapeo de campos?

Grafana envía un payload JSON con status, un bloque commonLabels y un array alerts. Pocket Alert lo lee con rutas GJSON, así que asignas commonLabels.alertname al título, alerts.0.annotations.summary al cuerpo y status para mostrar firing o resolved.

### ¿Puedo mostrar la gravedad y el estado?

Sí. El payload incluye la etiqueta de gravedad en commonLabels.severity y un status de firing o resolved. Usa ambos en tu plantilla de mensaje GJSON para que una alerta crítica en disparo se vea distinta de una resuelta.

### ¿Puedo separar las alertas por equipo?

Asigna a cada carpeta o equipo de Grafana su propia aplicación. Las alertas de infraestructura y de aplicaciones llegan a canales separados, y puedes silenciar uno sin tocar el otro.

### ¿Necesito un plugin?

Nada extra. Pocket Alert recibe el webhook que Grafana ya envía desde su motor de alertas, así que no hay plugin ni agente que instalar. Funciona igual con Grafana Cloud que autoalojado.

### ¿Puedo asignar la gravedad de la alerta a la prioridad de la notificación?

Sí. Cada mensaje acepta una prioridad: silent, low, default, high o critical. Incluye un campo "level" en el payload o define default_level en el webhook para que todo lo enviado por él llegue con esa prioridad; un level explícito en el payload tiene prioridad. Una combinación firing=critical y resolved=silent funciona bien: la alerta en disparo atraviesa No molestar y la recuperación queda en silencio en el historial. Un valor no válido usa default en lugar de rechazarse.
