# Sachez quand votre base de données cesse de répondre.

> Recevez une notification push dès que votre base de données tombe. Perte de connexion Postgres, MySQL ou Redis, retard de réplication ou disque plein : l’alerte arrive sur votre téléphone en moins d’une seconde.

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

Dernière mise à jour : 2026-08-11

Un contrôle de santé échoué, une réplique en retard, un disque qui se remplit. Votre supervision envoie un webhook à Pocket Alert et l’alerte atteint votre téléphone en moins d’une seconde. Compatible avec PostgreSQL, MySQL, Redis et MongoDB, sans agent sur l’hôte de la base de données.

## Trois étapes pour recevoir vos alertes de base de données sur votre téléphone

1. **Créez un webhook ou une clé** — Créez une clé API pour un script cron, ou un webhook, puis copiez son URL de réception.
2. **Branchez votre supervision** — Ajoutez l’URL de réception à Grafana, Alertmanager ou pgwatch, ou appelez l’API des messages avec curl depuis un contrôle cron.
3. **Soyez alerté** — Un contrôle échoué déclenche l’alerte et votre téléphone vibre en moins d’une seconde. Utilisez des webhooks distincts pour le primaire et les réplicas.

## Du gestionnaire d’alertes à votre poche

Votre supervision sait déjà quand une base de données ne va pas bien. Pocket Alert vous le fait savoir sur votre téléphone.

- **Tous les types de panne** — Connexion refusée, retard de réplication au-delà du seuil, WAL qui s'accumule, disque presque plein. Chaque contrôle lancé par votre supervision peut déclencher une notification push.
- **Compatible avec votre pile** — Grafana, Prometheus Alertmanager, pgwatch, Datadog et Zabbix envoient un POST vers l'URL de webhook que vous configurez déjà pour vos autres alertes.
- **La gravité dans le titre** — Une panne du primaire et un avertissement de retard de réplication arrivent sous forme d'alertes distinctes. Le mappage GJSON extrait la gravité de la charge utile pour l'intégrer au titre.
- **Canaux par base de données** — Chaque base de données dispose de sa propre application : la production, la préproduction et le réplica d'analyse ne partagent jamais un canal.
- **Distribution en moins d'une seconde** — Les notifications push arrivent en moins d'une seconde, assez vite pour lancer une bascule avant que le pool de connexions ne se vide.
- **Aucun agent requis** — Rien à installer sur l'hôte de la base de données. C'est votre supervision actuelle qui fait le travail.

## Reliez votre supervision de base de données à votre téléphone

### 1. Envoyez directement depuis un script de contrôle de santé

Un contrôle pg_isready ou une requête de connexions ou de requêtes lentes dans un script cron peut appeler l’API des messages avec votre clé API dans l’en-tête 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
```

Le champ `"level":"critical"` permet à cette notification push de contourner le mode Ne pas déranger, afin qu’une panne du primaire à 3 h du matin vous parvienne réellement. La page [alertes critiques](https://pocketalert.app/fr/use-cases/critical-alerts) explique le fonctionnement des niveaux.

Le même schéma fonctionne pour un retard de réplication ou un volume de données plein :

```
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. Ou créez un webhook pour votre gestionnaire d’alertes

Créez un webhook avec un modèle de message GJSON `message` qui fait correspondre la charge utile de vos outils. Grafana, Alertmanager, pgwatch, Datadog et Zabbix envoient tous leur propre JSON en POST :

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

Ajoutez l’URL de réception `https://p4a.me/wh/1234abcd` dans le récepteur de webhook de l’alert manager. Un contrôle cron peut aussi envoyer du JSON simple en POST vers la même URL de réception.

La [documentation des paramètres des webhooks](https://info.pocketalert.app/api/webhooks/settings.html) couvre le mappage des champs GJSON et le routage par application.

## FAQ

### Comment recevoir une notification push quand ma base de données tombe ?

Configurez votre pile de supervision pour envoyer un POST vers un webhook Pocket Alert lorsqu'un contrôle échoue. Grafana, Prometheus Alertmanager, pgwatch, Datadog et Zabbix prennent tous en charge les webhooks sortants, et un script cron de contrôle de santé peut appeler la même URL avec curl.

### Quelles bases de données sont prises en charge ?

PostgreSQL, MySQL, Redis et MongoDB fonctionnent tous. Pocket Alert lit le JSON envoyé par vos outils, donc le moteur de base de données n'a pas d'importance. Si un outil peut déclencher un webhook ou exécuter un script de contrôle, il peut vous joindre sur votre téléphone.

### Puis-je distinguer une panne du primaire d'un avertissement de retard ?

Attribuez des webhooks distincts au primaire et aux réplicas, ou utilisez un modèle GJSON qui extrait la gravité de la charge utile pour l'intégrer au titre. Une panne du primaire et un avertissement de retard de réplication s'afficheront alors différemment dès leur arrivée.

### Comment séparer les alertes de production et de préproduction ?

Donnez à chaque base de données sa propre application et son propre webhook. La production, la préproduction et le réplica d'analyse arrivent dans des canaux séparés, ainsi une machine de préproduction bruyante ne noiera jamais un vrai incident en production.

### Ai-je besoin d'un agent sur le serveur de base de données ?

Non. Pocket Alert n'exécute aucun agent sur l'hôte de la base de données. Le script de supervision ou de contrôle de santé que vous utilisez déjà déclenche le webhook, et les notifications push arrivent en moins d'une seconde.

### Une alerte de base de données hors service peut-elle me réveiller la nuit ?

Oui. Envoyez-la avec level=critical, ou définissez default_level sur critical pour le webhook afin que tout ce qu'il reçoit soit prioritaire. Sur Android, les alertes critiques sont publiées dans un canal dédié qui contourne le mode Ne pas déranger une fois l'accès accordé, et peuvent prendre tout l'écran ; sur iPhone, elles arrivent sous forme de notification urgente qui traverse le mode Concentration. L'offre gratuite envoie les alertes critiques avec une priorité élevée, toujours instantanément, mais sans le contournement du mode Ne pas déranger.
