# Fai in modo che gli alert di Grafana raggiungono il tuo telefono.

> Ricevi gli alert di Grafana come notifiche push. Aggiungi Pocket Alert come contact point webhook e vedi le regole di alert attive sul tuo telefono in meno di un secondo.

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

Ultimo aggiornamento: 2026-08-11

Quando una regola di alert di Grafana scatta, il nome dell'alert, la gravità e lo stato arrivano sul telefono in meno di un secondo. Vedi i problemi prima che la dashboard diventi rossa, senza tenere uno schermo aperto.

## Tre passaggi per gli alert di Grafana sul telefono

1. **Crea un webhook** — Crea un webhook Pocket Alert con un template messaggio GJSON e copia il suo URL di ricezione.
2. **Collega il contact point** — Aggiungi l'URL come contact point di tipo Webhook in Grafana Alerting e collegalo a una notification policy.
3. **Mappa e invia** — GJSON mappa status, alertname, severity e il summary nella tua push. Il prossimo alert in firing fa vibrare il telefono.

## Dal pannello in allarme alla schermata di blocco

Grafana invia già un webhook quando una regola di alert scatta. Pocket Alert lo trasforma in una notifica push che non puoi perdere.

- **Un contact point standard** — Aggiungi Pocket Alert come contact point di tipo Webhook in Grafana Alerting. Nessun plugin, nessun agente, funziona su Cloud e self-hosted.
- **Mappa i campi con GJSON** — I percorsi GJSON estraggono alertname, status e l'annotazione summary direttamente dal payload di Grafana nella tua notifica.
- **Gravità e stato inline** — Mostra l'etichetta di gravità e lo stato firing/resolved direttamente nella push, così un alert critico appare diverso da un ripristino.
- **Un canale per team** — Ogni applicazione ha il proprio URL webhook, quindi gli alert di infrastruttura, delle app e dei singoli team restano in canali separati.
- **Consegna in meno di un secondo** — L'alert in firing arriva sul telefono in meno di un secondo, molto prima che qualcuno apra la dashboard.
- **URL webhook segreto** — L'URL webhook è il segreto della tua applicazione su HTTPS. Rigeneralo ogni volta che ti serve un endpoint nuovo.

## Invia gli alert di Grafana al telefono

### 1. Crea un webhook Pocket Alert

Nella pagina [Webhooks](https://pocketalert.app/it/webhooks) crea un webhook il cui template GJSON `message` legge il payload di Grafana. Grafana invia `status`, un blocco `commonLabels` e un array `alerts`, quindi un buon template è:

```
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"}'
```

Ottieni un URL in ingresso come `https://p4a.me/wh/1234abcd`.

### 2. Aggiungilo come contact point di tipo Webhook

In Grafana vai su [Alerting → Contact points → Add contact point](https://grafana.com/docs/grafana/latest/alerting/configure-notifications/manage-contact-points/integrations/webhook-notifier/), scegli l'integrazione Webhook e incolla l'URL di ricezione:

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

Collega il contact point a una notification policy così gli alert corrispondenti vi vengono instradati. Grafana invia il suo JSON standard; i percorsi GJSON sopra estraggono `status`, `commonLabels.alertname`, `commonLabels.severity` e `alerts.0.annotations.summary` nella push.

### 3. Esegui un test

Usa il pulsante Test del contact point. Un alert in firing arriva come `[firing] HighCPU (critical)`; quando rientra, `status` passa a `resolved`.

La [documentazione delle impostazioni webhook](https://info.pocketalert.app/api/webhooks/settings.html) descrive ogni percorso GJSON e ogni opzione del webhook.

## FAQ

### Come invio gli alert di Grafana al telefono?

In Grafana vai su Alerting → Contact points, aggiungi un contact point di tipo Webhook e incolla l'URL della tua applicazione Pocket Alert. Collegalo a una notification policy e il prossimo alert in stato firing arriva sul telefono in meno di un secondo.

### Come funziona la mappatura dei campi?

Grafana invia un payload JSON con status, un blocco commonLabels e un array alerts. Pocket Alert lo legge con i percorsi GJSON, quindi mappi commonLabels.alertname sul titolo, alerts.0.annotations.summary sul corpo e status per mostrare firing o resolved.

### Posso mostrare gravità e stato?

Sì. Il payload contiene l'etichetta di gravità in commonLabels.severity e uno stato firing o resolved. Richiamali entrambi nel template del messaggio GJSON, così un alert critico in firing appare diverso da uno risolto.

### Posso separare gli alert per team?

Assegna a ogni cartella o team di Grafana una propria applicazione. Gli alert di infrastruttura e quelli delle app finiscono in canali separati e puoi silenziarne uno senza toccare l'altro.

### Serve un plugin?

Nient'altro. Pocket Alert riceve il webhook che Grafana invia già dal suo motore di alerting, quindi non c'è nessun plugin o agente da installare. Funziona allo stesso modo con Grafana Cloud e self-hosted.

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

Sì. Ogni messaggio accetta un livello: silent, low, default, high o critical. Includi un campo "level" nel payload oppure imposta default_level sul webhook, così tutto ciò che vi viene instradato arriva con quella priorità; un level esplicito nel payload ha la precedenza. Una divisione firing=critical, resolved=silent funziona bene: l'alert in firing supera Non disturbare, mentre il ripristino resta silenzioso nella cronologia. Un valore non valido ricade su default e non viene mai rifiutato.
