# Fai in modo che i monitor Datadog arrivano sul tuo telefono.

> Ricevi gli alert dei monitor Datadog come notifiche push. Registra Pocket Alert come webhook e scopri subito sul telefono quando una soglia viene superata, in meno di un secondo.

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

Ultimo aggiornamento: 2026-08-11

Quando un monitor Datadog si attiva, l'avviso e la sua gravità arrivano sul tuo telefono in meno di un secondo. Intercetta l'incidente prima che diventi un'emergenza.

## Tre passaggi per gli avvisi Datadog sul telefono

1. **Crea un webhook** — Crea un webhook Pocket Alert con un template di messaggio GJSON e copia il suo URL di ricezione.
2. **Collega il webhook** — Registra l'URL nell'integrazione Webhook di Datadog con un payload personalizzato $EVENT_TITLE / $TEXT_ONLY_MSG, poi richiamalo da un monitor.
3. **Mappa e invia** — GJSON associa titolo, messaggio e transizione dell'evento alla tua notifica push. Il prossimo attivazione farà vibrare il telefono.

## Dal monitor in violazione alla schermata di blocco

Datadog invia già un webhook quando un monitor supera la soglia. Pocket Alert lo trasforma in una notifica push che non puoi perdere.

- **Si integra con i webhook Datadog** — Registra Pocket Alert nell'integrazione Webhook di Datadog e richiamalo con @webhook-pocketalert da qualsiasi monitor.
- **Variabili template in ingresso, GJSON in uscita** — Le variabili template di Datadog riempiono il corpo JSON. I percorsi GJSON in Pocket Alert estraggono titolo, messaggio e transizione dell'evento nella tua notifica.
- **Attivato vs ripristinato** — Mappa $ALERT_TRANSITION così un monitor attivato appare diverso da un ripristino, direttamente sulla schermata di blocco.
- **Un canale per ambiente** — Ogni applicazione ha il proprio URL webhook, così i monitor di infrastruttura, APM e per team restano in canali separati.
- **Consegna in meno di un secondo** — La violazione raggiunge il tuo telefono in meno di un secondo, ben prima che si attivi la policy di escalation.
- **URL webhook segreto** — L'URL del webhook è il segreto della tua applicazione su HTTPS. Ruotalo ogni volta che ti serve un nuovo endpoint.

## Invia gli avvisi Datadog sul tuo telefono

### 1. Crea un webhook Pocket Alert

Nella pagina [Webhook](https://pocketalert.app/it/webhooks) crea un webhook con un template di `message` GJSON che mappa il payload Datadog che invierai. Puoi crearlo anche tramite 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"}'
```

Ottieni un URL in ingresso simile a `https://p4a.me/wh/1234abcd`. I percorsi GJSON sopra (`%event_title%`, `%alert_transition%`, `%body%`, `%link%`) leggono le chiavi JSON che Datadog invierà nel passaggio successivo.

### 2. Registra il webhook in Datadog

Vai su [Integrazioni → Webhook](https://docs.datadoghq.com/integrations/webhooks/) e aggiungi un nuovo webhook. Incolla l'URL di ricezione e definisci un payload personalizzato con le variabili template di 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. Richiamalo da un monitor

Aggiungi `@webhook-pocketalert` al messaggio del monitor. Quando il monitor si attiva, Datadog invia il payload sopra; Pocket Alert genera il template GJSON e invia la notifica. Un ripristino invia `$ALERT_TRANSITION = Recovered`, quindi lo stesso avviso mostra "Recovered" quando rientra.

La [documentazione delle impostazioni dei webhook](https://info.pocketalert.app/api/webhooks/settings.html) descrive tutti i percorsi GJSON e le opzioni dei webhook.

## FAQ

### Come invio gli avvisi Datadog sul telefono?

Crea un webhook Pocket Alert, copia il suo URL di ricezione, poi registralo in Datadog da Integrazioni → Webhook. Richiamalo con @webhook-pocketalert da qualsiasi messaggio di un monitor e l'avviso arriva sul tuo telefono in meno di un secondo.

### Come funziona la mappatura dei campi?

Nel webhook Datadog definisci il corpo JSON con variabili template come $EVENT_TITLE, $TEXT_ONLY_MSG, $ALERT_TRANSITION e $LINK. Pocket Alert legge quel JSON con i percorsi GJSON, quindi il tuo template di messaggio associa questi campi al titolo e al corpo della notifica.

### Posso mostrare la transizione e la gravità dell'avviso?

Sì. Includi $ALERT_TRANSITION (Triggered / Recovered) oppure $ALERT_TYPE nel payload e fanne riferimento nel template del messaggio, così un monitor attivato appare diverso da un ripristino. Datadog espone anche $PRIORITY e $ALERT_STATUS, se li vuoi nel testo.

### Posso separare produzione e staging?

Registra un webhook per ambiente o per team e richiama quello giusto da ogni monitor. Produzione e staging finiscono in canali separati che puoi silenziare indipendentemente.

### Serve un altro agent?

Niente sull'host. Pocket Alert riceve il webhook che Datadog invia dal suo motore di monitoraggio, quindi non serve alcun agent oltre al Datadog Agent che già usi.

### Posso associare la gravità dell'avviso alla priorità della notifica?

Sì. Poiché definisci tu il payload del webhook, aggiungi un campo "level" accanto a $EVENT_TITLE — silent, low, default, high oppure critical — e Pocket Alert lo associa alla priorità della notifica. Invia critical da un monitor che richiede di essere avvisati subito, così supera Non disturbare, oppure imposta default_level sul webhook e ometti il campo; un level esplicito ha sempre la precedenza. Un valore non valido ricade su default, senza essere rifiutato.
