# Faites en sorte que les alertes Grafana atteignent votre téléphone.

> Recevez vos alertes Grafana en notifications push. Ajoutez Pocket Alert comme point de contact webhook et soyez prévenu des règles d’alerte déclenchées sur votre téléphone en moins d’une seconde.

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

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

Quand une règle d’alerte Grafana se déclenche, le nom de l’alerte, sa gravité et son statut arrivent sur votre téléphone en moins d’une seconde. Repérez les problèmes avant que le tableau de bord ne passe au rouge, sans garder un écran ouvert.

## Trois étapes pour recevoir les alertes Grafana sur votre téléphone

1. **Créer un webhook** — Créez un webhook Pocket Alert avec un modèle de message GJSON et copiez son URL de réception.
2. **Configurer le point de contact** — Ajoutez l’URL comme point de contact Webhook dans Grafana Alerting et associez-le à une politique de notification.
3. **Mapper et envoyer** — GJSON associe status, alertname, severity et le résumé à votre notification push. La prochaine alerte déclenchée fera vibrer votre téléphone.

## Du panneau en alerte à l’écran verrouillé

Grafana déclenche déjà un webhook lorsqu’une règle d’alerte se déclenche. Pocket Alert le transforme en notification push impossible à manquer.

- **Un point de contact standard** — Ajoutez Pocket Alert comme point de contact Webhook dans Grafana Alerting. Pas d’extension, pas d’agent, compatible Cloud et auto-hébergé.
- **Mappage des champs avec GJSON** — Les chemins GJSON extraient alertname, status et l’annotation summary directement de la charge utile Grafana vers votre notification.
- **Gravité et statut dans le message** — Affichez le label de gravité et le statut firing/resolved directement dans la notification push, pour qu’une alerte critique se distingue d’une résolution.
- **Un canal par équipe** — Chaque application dispose de sa propre URL de webhook : alertes d’infrastructure, d’applicatif et par équipe restent dans des canaux séparés.
- **Livraison en moins d’une seconde** — L’alerte déclenchée atteint votre téléphone en moins d’une seconde, bien avant que quiconque ouvre le tableau de bord.
- **URL de webhook secrète** — L’URL du webhook est le secret de votre application, transmis en HTTPS. Régénérez-la à tout moment pour obtenir un nouveau point d’entrée.

## Envoyer les alertes Grafana sur votre téléphone

### 1. Créer un webhook Pocket Alert

Sur la page [Webhooks](https://pocketalert.app/fr/webhooks), créez un webhook dont le modèle GJSON `message` lit la charge utile Grafana. Grafana envoie `status`, un bloc `commonLabels` et un tableau `alerts`, donc un bon modèle est :

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

Vous obtenez une URL entrante du type `https://p4a.me/wh/1234abcd`.

### 2. L’ajouter comme point de contact Webhook

Dans Grafana, rendez-vous dans [Alerting → Contact points → Add contact point](https://grafana.com/docs/grafana/latest/alerting/configure-notifications/manage-contact-points/integrations/webhook-notifier/), choisissez l’intégration Webhook et collez l’URL de réception :

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

Associez le point de contact à une politique de notification afin que les alertes correspondantes y soient routées. Grafana envoie son JSON standard ; les chemins GJSON ci-dessus extraient `status`, `commonLabels.alertname`, `commonLabels.severity` et `alerts.0.annotations.summary` dans la notification push.

### 3. Lancer un test

Utilisez le bouton Test du point de contact. Une alerte déclenchée arrive sous la forme `[firing] HighCPU (critical)` ; lorsqu’elle se résout, `status` passe à `resolved`.

La [documentation des paramètres des webhooks](https://info.pocketalert.app/api/webhooks/settings.html) détaille tous les chemins GJSON et toutes les options de webhook.

## FAQ

### Comment envoyer les alertes Grafana sur mon téléphone ?

Dans Grafana, rendez-vous dans Alerting → Contact points, ajoutez un point de contact de type Webhook et collez l’URL de votre application Pocket Alert. Associez-le à une politique de notification et la prochaine alerte déclenchée atteindra votre téléphone en moins d’une seconde.

### Comment fonctionne le mappage des champs ?

Grafana envoie une charge utile JSON contenant status, un bloc commonLabels et un tableau alerts. Pocket Alert la lit avec des chemins GJSON : vous associez commonLabels.alertname au titre, alerts.0.annotations.summary au corps, et status pour afficher firing ou resolved.

### Puis-je afficher la gravité et le statut ?

Oui. La charge utile contient le label de gravité à commonLabels.severity et un status valant firing ou resolved. Référencez les deux dans votre modèle de message GJSON pour qu’une alerte critique déclenchée se lise différemment d’une alerte résolue.

### Puis-je séparer les alertes par équipe ?

Attribuez à chaque dossier ou équipe Grafana sa propre application. Les alertes d’infrastructure et d’applicatif arrivent dans des canaux distincts, et vous pouvez en couper une sans toucher à l’autre.

### Ai-je besoin d’une extension ?

Rien de plus. Pocket Alert reçoit le webhook que Grafana envoie déjà depuis son moteur d’alerting, il n’y a donc ni extension ni agent à installer. Fonctionne aussi bien avec Grafana Cloud qu’en auto-hébergement.

### Puis-je associer la gravité de l’alerte à la priorité de notification ?

Oui. Chaque message accepte un niveau : silent, low, default, high ou critical. Ajoutez un champ « level » dans la charge utile, ou définissez default_level sur le webhook pour que tout ce qui y est routé arrive à cette priorité ; un level explicite dans la charge utile prime. Une répartition firing=critical, resolved=silent fonctionne bien : l’alerte déclenchée passe outre le mode Ne pas déranger, tandis que la résolution reste discrète dans l’historique. Une valeur invalide revient à default, elle n’est jamais rejetée.
