# Haz que los monitores de Datadog llegue a tu teléfono.

> Recibe las alertas de monitores de Datadog como notificaciones push. Registra Pocket Alert como webhook y entérate de cada incidencia en tu teléfono en menos de un segundo.

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

Última actualización: 2026-08-11

Cuando un monitor de Datadog se activa, la alerta y su gravedad llegan a tu teléfono en menos de un segundo. Detecta el incidente antes de que escale a un aviso de guardia.

## Tres pasos para tener alertas de Datadog 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 webhook** — Registra la URL en la integración de Webhooks de Datadog con un payload personalizado de $EVENT_TITLE / $TEXT_ONLY_MSG, y después llámala desde un monitor.
3. **Mapea y envía** — GJSON asigna el título del evento, el mensaje y la transición a tu push. El siguiente disparo hará vibrar tu teléfono.

## Del monitor que supera el umbral a la pantalla de bloqueo

Datadog ya envía un webhook cuando un monitor supera el umbral. Pocket Alert lo convierte en una notificación push que no vas a pasar por alto.

- **Se conecta a los webhooks de Datadog** — Registra Pocket Alert en la integración de Webhooks de Datadog y llámalo con @webhook-pocketalert desde cualquier monitor.
- **Variables de plantilla dentro, GJSON fuera** — Las variables de plantilla de Datadog rellenan el cuerpo JSON. Las rutas GJSON de Pocket Alert extraen el título del evento, el mensaje y la transición para tu notificación.
- **Activado frente a recuperado** — Asigna $ALERT_TRANSITION para que un monitor activado se lea distinto de una recuperación, directamente en la pantalla de bloqueo.
- **Un canal por entorno** — Cada aplicación tiene su propia URL de webhook, así que la infraestructura, APM y los monitores por equipo se mantienen en canales separados.
- **Entrega en menos de un segundo** — La superación del umbral llega a tu teléfono en menos de un segundo, mucho antes de que se active la política de escalado.
- **URL de webhook secreta** — La URL del webhook es tu secreto de aplicación sobre HTTPS. Rótala cuando necesites un endpoint nuevo.

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

### 1. Crea un webhook de Pocket Alert

En la página de [Webhooks](https://pocketalert.app/es/webhooks) crea un webhook con una plantilla de `message` GJSON que mapee el payload de Datadog que vas a enviar. También puedes crearlo con la API:

```
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Datadog","message":"%event_title% — %alert_transition%\n%body%\n%link%","application_id":"qm47b9pzxzxg"}'
```

Obtienes una URL de entrada como `https://p4a.me/wh/1234abcd`. Las rutas GJSON de arriba (`%event_title%`, `%alert_transition%`, `%body%`, `%link%`) leen las claves JSON que Datadog enviará en el siguiente paso.

### 2. Registra el webhook en Datadog

Ve a [Integraciones → Webhooks](https://docs.datadoghq.com/integrations/webhooks/) y añade un webhook nuevo. Pega la URL de recepción y define un payload personalizado con variables de plantilla de Datadog:

```
Name:    pocketalert
URL:     https://p4a.me/wh/1234abcd
Payload: {
  "event_title": "$EVENT_TITLE",
  "body": "$TEXT_ONLY_MSG",
  "alert_transition": "$ALERT_TRANSITION",
  "level": "critical",
  "link": "$LINK"
}
```

### 3. Llámalo desde un monitor

Añade `@webhook-pocketalert` al mensaje del monitor. Cuando el monitor se activa, Datadog envía el payload anterior con POST; Pocket Alert renderiza la plantilla GJSON y envía la notificación. Una recuperación envía `$ALERT_TRANSITION = Recovered`, así que la misma alerta muestra "Recovered" cuando se resuelve.

La [documentación de configuración de webhooks](https://info.pocketalert.app/api/webhooks/settings.html) explica cada ruta GJSON y cada opción de webhook.

## Preguntas frecuentes

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

Crea un webhook de Pocket Alert, copia su URL de recepción y regístrala en Datadog en Integraciones → Webhooks. Llámalo con @webhook-pocketalert desde cualquier mensaje de monitor y la alerta llega a tu teléfono en menos de un segundo.

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

En el webhook de Datadog defines el cuerpo JSON con variables de plantilla como $EVENT_TITLE, $TEXT_ONLY_MSG, $ALERT_TRANSITION y $LINK. Pocket Alert lee ese JSON con rutas GJSON, así que tu plantilla de mensaje asigna esos campos al título y al cuerpo de la notificación.

### ¿Puedo mostrar la transición y la gravedad de la alerta?

Sí. Incluye $ALERT_TRANSITION (Triggered / Recovered) o $ALERT_TYPE en el payload y referencíalo en la plantilla de mensaje, para que un monitor activado se lea distinto de una recuperación. Datadog también expone $PRIORITY y $ALERT_STATUS si quieres incluirlos en el texto.

### ¿Puedo separar producción y staging?

Registra un webhook por entorno o equipo y referencia el correcto desde cada monitor. Producción y staging llegan a canales separados que puedes silenciar de forma independiente.

### ¿Necesito otro agente?

Nada en un host. Pocket Alert recibe el webhook que Datadog envía desde su motor de monitores, así que no necesitas otro agente además del Datadog Agent que ya ejecutas.

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

Sí. Como defines tú el payload del webhook, añade un campo "level" junto a $EVENT_TITLE (silent, low, default, high o critical), y Pocket Alert lo asigna a la prioridad de la notificación. Envía critical desde un monitor de guardia para que atraviese el modo No molestar, o define default_level en el webhook y omite el campo; un level explícito siempre tiene prioridad. Un valor no válido usa default en lugar de rechazarse.
