# Sachez la seconde quand un serveur tombe en panne.

> Recevez des alertes push instantanées quand vos serveurs tombent. Connectez Grafana, Prometheus ou UptimeRobot via webhook et recevez les alertes sur votre téléphone en moins d’une seconde.

<!-- source: https://pocketalert.app/fr/use-cases/server-monitoring -->

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

Pocket Alert transforme les alertes de supervision serveur en notifications push sur votre iPhone ou votre Android. Reliez Grafana, Prometheus, UptimeRobot ou un simple contrôle de santé cron à une seule URL de webhook : les alertes atteignent votre téléphone en moins d’une seconde, sans agent sur la machine et sans récapitulatif par e-mail à parcourir.

## Trois étapes pour votre première alerte serveur

1. **Configurer Pocket Alert** — Installez la CLI pocketalert et exécutez pocketalert auth YOUR_API_KEY, ou créez un webhook pour le transfert.
2. **Relier la supervision** — Ajoutez un contrôle de santé cron, un custom_sender Netdata ou un webhook_config Alertmanager pointant vers l’URL de réception.
3. **Recevez l’alerte** — Déclenchez une alerte de test, et votre téléphone vibrera un instant plus tard. Associez les champs pour affiner le contenu.

## Du pic de métriques à votre téléphone

Pointez votre supervision vers une seule URL de webhook, et chaque alerte atteint votre téléphone en moins d’une seconde.

- **Fonctionne avec votre pile** — Grafana, Prometheus, UptimeRobot, Datadog et Zabbix atteignent votre téléphone dès qu’ils déclenchent un webhook.
- **Livraison en moins d’une seconde** — La notification push arrive en moins d’une seconde, avant la première plainte d’un utilisateur.
- **Association des champs (GJSON)** — Associez les champs de la charge utile JSON au titre et au message. Le nom et la gravité de l’alerte sont repris dans la notification.
- **Script ou webhook** — Un contrôle de santé cron ou une alerte Alertmanager transférée arrivent sur votre téléphone de la même manière.
- **Canaux par application** — Donnez à la production, à la préproduction et au homelab leurs propres canaux.
- **Aucun agent requis** — Pocket Alert consomme les webhooks que votre outil de supervision produit déjà, donc la machine surveillée n’exécute rien de supplémentaire.

## Configurer votre supervision

### 1. Un contrôle de santé bash via cron

Installez la CLI, authentifiez-vous une fois, puis interrogez le service et envoyez une notification push s’il ne répond pas.

```
sudo mv pocketalert /usr/local/bin/ && chmod +x /usr/local/bin/pocketalert
pocketalert auth YOUR_API_KEY
```

```
#!/usr/bin/env bash
URL=https://api.example.com/health
if ! curl -fsS --max-time 10 "$URL" >/dev/null; then
  pocketalert send -t "API DOWN on $(hostname)" -m "$URL did not respond"
fi
```

Exécutez-le chaque minute depuis cron.

```
* * * * * /usr/local/bin/check-health.sh
```

### 2. Ou un hook d’alarme Netdata

Ajoutez une `custom_sender()` dans `health_alarm_notify.conf` (modifiable via `sudo ./edit-config health_alarm_notify.conf`) afin que chaque alarme Netdata envoie ses données à l’API des messages.

```
custom_sender() {
  curl -X POST 'https://api.pocketalert.app/v1/messages' \
    -H 'Token: YOUR_API_KEY' \
    -H 'Content-Type: application/json' \
    -d "{\"title\":\"${name} is ${status} on ${host}\",\"message\":\"${chart}.${family}: ${value_string}\",\"level\":\"critical\"}"
}
```

### 3. Ou transférer Alertmanager via un webhook

Créez un webhook sur la page [Webhooks](https://pocketalert.app/fr/webhooks) avec un modèle GJSON, puis ajoutez l’URL de réception à un `webhook_config` de Prometheus Alertmanager.

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

```
receivers:
  - name: pocketalert
    webhook_configs:
      - url: 'https://p4a.me/wh/1234abcd'
        send_resolved: true
```

La [documentation](https://info.pocketalert.app/api/webhooks/settings.html) répertorie les chemins GJSON.

## FAQ

### Comment fonctionnent les alertes de supervision serveur ?

Pocket Alert attribue à chaque application une URL de webhook entrant. Configurez un outil de supervision comme Grafana, Prometheus Alertmanager, UptimeRobot, Datadog ou Zabbix pour envoyer ses alertes à cette URL, et elles deviennent des notifications push sur votre téléphone en moins d’une seconde.

### Puis-je personnaliser le contenu des alertes ?

Oui. Associez les champs du JSON entrant à des chemins GJSON pour définir le titre et le message de la notification. Une alerte Alertmanager conserve son nom, son statut et sa gravité jusqu’au bout.

### Quels outils de supervision sont pris en charge ?

Tout outil qui envoie une requête HTTP lors d’une alerte fonctionne : Grafana, Prometheus Alertmanager, UptimeRobot, Datadog, Zabbix, Netdata, Uptime Kuma et vos scripts personnalisés de contrôle de santé.

### Comment éviter la fatigue liée aux alertes ?

Envoyez une notification push lorsqu’un serveur tombe, et une autre lorsqu’il revient. Des canaux par application séparent la production, la préproduction et l’infrastructure personnelle, afin que les alertes urgentes ne se perdent pas dans un flux bruyant.

### Faut-il installer un agent sur mes serveurs ?

Aucun agent à installer. Pocket Alert reçoit les webhooks que votre outil de supervision envoie déjà, donc rien de supplémentaire ne s’exécute sur le serveur surveillé.

### Une alerte de panne serveur peut-elle passer le mode Ne pas déranger la nuit ?

Oui. Envoyez l’alerte avec level: critical et elle contourne le mode Ne pas déranger sur Android, et traverse le mode Concentration sur iPhone sous forme de notification sensible au temps. Gardez les messages de rétablissement au niveau par défaut, ou en silencieux, pour que seule la panne fasse du bruit. Les niveaux vont de silencieux (-2) à critique (2) et fonctionnent dans l’API, dans les charges utiles des webhooks et comme valeur par défaut par webhook.
