# Scopri subito quando il tuo database smette di rispondere.

> Ricevi una notifica push quando il tuo database va in crisi. Perdita di connessione a Postgres, MySQL o Redis, replication lag o disco pieno arrivano sul tuo telefono in meno di un secondo.

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

Ultimo aggiornamento: 2026-08-11

Un health check fallito, una replica in ritardo, un disco che si avvicina al limite. Il tuo monitoraggio invia un webhook a Pocket Alert e l'avviso raggiunge il telefono in meno di un secondo. Funziona con Postgres, MySQL, Redis e MongoDB, e non richiede alcun agent sull'host del database.

## Tre passaggi per avere gli avvisi del database sul telefono

1. **Crea un webhook o una chiave** — Crea una chiave API per uno script cron, oppure un webhook e copia il suo URL di ricezione.
2. **Collega il monitoraggio** — Aggiungi l'URL di ricezione a Grafana, Alertmanager o pgwatch, oppure usa curl sull'API dei messaggi da un health check cron.
3. **Ricevi l'avviso** — Un controllo fallito fa scattare l'avviso e il telefono vibra in meno di un secondo. Usa webhook separati per il primary e le repliche.

## Dal gestore degli avvisi alla tua tasca

Il tuo monitoraggio sa già quando un database non è in salute. Pocket Alert lo porta sul tuo telefono.

- **Ogni tipo di guasto** — Connessione rifiutata, ritardo di replica oltre la soglia, WAL che si accumula, disco quasi pieno. Qualsiasi controllo eseguito dal tuo monitoraggio può inviare una notifica push.
- **Funziona con il tuo stack** — Grafana, Prometheus Alertmanager, pgwatch, Datadog e Zabbix inviano una POST all'URL del webhook che hai già configurato per gli altri avvisi.
- **Gravità nel titolo** — Un primary fuori uso e un avviso di ritardo di una replica arrivano come avvisi distinti. Il mapping GJSON legge la gravità dal payload e la inserisce nel titolo.
- **Canali per database** — Ogni database ha una propria applicazione, quindi prod, staging e la replica per l'analytics non condividono mai un canale.
- **Consegna in meno di un secondo** — Le notifiche arrivano in meno di un secondo, abbastanza in fretta da avviare un failover prima che il connection pool si svuoti.
- **Nessun agent richiesto** — Nulla da installare sull'host del database. Il monitoraggio che usi già fa tutto il lavoro.

## Collega il monitoraggio del database al telefono

### 1. Invia una POST direttamente da uno script di health check

Un controllo pg_isready o una query su query lente/numero di connessioni in uno script cron può usare curl sull'API dei messaggi con la tua chiave API nell'header Token:

```
#!/usr/bin/env bash
# /usr/local/bin/pg-health.sh (run from cron)
if ! pg_isready -h prod-db -p 5432 -q; then
  curl -X POST "https://api.pocketalert.app/v1/messages" \
    -H "Token: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"title":"Postgres down","message":"prod-db: connection refused on 5432","level":"critical"}'
fi
```

Il campo `"level":"critical"` fa sì che questa notifica push superi Non disturbare, così un primary fuori uso alle 3 di notte ti raggiunge davvero. La pagina sugli [avvisi critici](https://pocketalert.app/it/use-cases/critical-alerts) spiega come funzionano i livelli.

Lo stesso schema funziona per il ritardo di replica o un volume dati pieno:

```
LAG=$(psql -tA -c "SELECT EXTRACT(EPOCH FROM (now() - pg_last_xact_replay_timestamp()))::int")
[ "$LAG" -gt 120 ] && curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"title\":\"Replication lag\",\"message\":\"replica-1 is ${LAG}s behind primary\"}"
```

### 2. Oppure crea un webhook per il tuo gestore degli avvisi

Crea un webhook con un template GJSON nel campo `message` che mappa il payload del tuo strumento. Grafana, Alertmanager, pgwatch, Datadog e Zabbix inviano tutti una POST con il proprio JSON:

```
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Alertmanager","message":"%alerts.0.labels.alertname%: %alerts.0.annotations.summary%","application_id":"qm47b9pzxzxg"}'
```

Inserisci l'URL di ricezione `https://p4a.me/wh/1234abcd` nel receiver webhook dell'alert manager. Uno script cron di controllo può anche inviare JSON semplice allo stesso URL di ricezione.

La [documentazione sulle impostazioni dei webhook](https://info.pocketalert.app/api/webhooks/settings.html) spiega il mapping dei campi GJSON e il routing per applicazione.

## FAQ

### Come ricevo una notifica push quando il database va giù?

Fai in modo che il tuo stack di monitoraggio invii una POST a un webhook di Pocket Alert quando un controllo fallisce. Grafana, Prometheus Alertmanager, pgwatch, Datadog e Zabbix supportano tutti i webhook in uscita, e uno script cron di health check può usare curl sullo stesso URL.

### Quali database sono supportati?

Funzionano Postgres, MySQL, Redis e MongoDB. Pocket Alert legge il JSON che invia il tuo strumento, quindi il motore del database non conta. Se può inviare un webhook o eseguire uno script di controllo, può raggiungere il tuo telefono.

### Posso distinguere un guasto del primary da un avviso di ritardo?

Assegna al primary e alle repliche webhook separati, oppure usa un template GJSON che estrae la gravità dal payload e la inserisce nel titolo. In questo modo un guasto del primary e un avviso di ritardo della replica risultano diversi già al primo sguardo.

### Come tengo separati gli avvisi di prod e staging?

Assegna a ciascun database la propria applicazione e il proprio URL webhook. Prod, staging e la replica per l'analytics arrivano su canali separati, così un server di staging rumoroso non copre mai un vero incidente in produzione.

### Serve un agent sul server del database?

No. Pocket Alert non richiede alcun agent sull'host del database. Qualsiasi sistema di monitoraggio o script di health check che usi già può inviare il webhook, e le notifiche arrivano in meno di un secondo.

### Un avviso di database fuori uso può svegliarmi di notte?

Sì. Invialo con level=critical, oppure imposta default_level su critical nel webhook così tutto ciò che riceve sarà ad alta priorità. Su Android, i critici vanno su un canale dedicato che ignora Non disturbare una volta concesso l'accesso a DND, e possono occupare lo schermo; su iPhone arrivano come notifica time-sensitive che supera Full immersion. Il piano gratuito consegna i critici come high, sempre istantanei, ma senza il superamento di DND.
