---
title: "Alertes Google Cloud Monitoring par appel via webhook"
description: "Cloud Monitoring envoie e-mails, SMS et push, mais n'appelle pas. Routez vos règles d'alerte GCP vers un webhook d'appel : mise en place, champs, filtres."
date: 2026-11-15
author: Nooc
authorAvatarLink: /images/avatars/nooc.webp
authorLink: https://nooc.me
tags:
  - Google Cloud
  - Cloud Monitoring
  - GCP
  - alertes par appel
  - webhooks
  - astreinte
---

# Alertes Google Cloud Monitoring par appel : de la règle d'alerte au téléphone qui sonne

Google Cloud Monitoring ne sait pas appeler votre téléphone. Ses canaux de notification sont l'e-mail, le SMS, l'application mobile Google Cloud, Slack, Google Chat, PagerDuty, Pub/Sub et les webhooks — et la documentation de Google reconnaît elle-même que le SMS n'est pas entièrement fiable et peut ne pas être disponible dans votre région. Si vous voulez qu'une règle d'alerte sonne comme un appel entrant, le chemin le plus court est un canal webhook pointé vers un canal d'appel Echobell, avec deux lignes de modèle et une condition.

Ce guide couvre le canal, le webhook, les champs que Cloud Monitoring envoie réellement dans le payload, comment faire sonner les incidents « open » et laisser muets les incidents « closed », et les réglages de la règle d'alerte qui décident de la fréquence à laquelle votre téléphone sonne.

## Pourquoi les canaux intégrés ne suffisent pas à 3 heures du matin

- **L'e-mail** attend que vous le regardiez.
- **Le SMS** n'est pas, selon Google, un type de canal entièrement fiable, et il n'est peut-être pas proposé dans votre pays. Ne pas déranger le fait aussi taire, comme n'importe quel autre message.
- **L'application mobile** envoie un push ordinaire. Il s'affiche sur l'écran verrouillé ; il ne continue pas de sonner.
- **PagerDuty** peut vous appeler, mais c'est une plateforme d'astreinte complète, avec sa propre configuration et son propre contrat.

Un canal webhook, en revanche, peut joindre n'importe quel endpoint HTTPS public, et Cloud Monitoring lui envoie un document JSON structuré pour chaque incident. C'est tout ce dont Echobell a besoin.

## Ce qu'il vous faut

- Un projet Google Cloud avec au moins une règle d'alerte (ou un test de disponibilité sur lequel vous voulez être alerté)
- Le droit de modifier les canaux de notification (`roles/monitoring.notificationChannelEditor` ou Monitoring Editor)
- Echobell installé ([App Store](https://apps.apple.com/app/apple-store/id6743597198?pt=128151925&ct=blog-google-cloud-monitoring-phone-call-alerts-fr&mt=8) / [Google Play](https://play.google.com/store/apps/details?id=one.echobell.echobellandroid))
- Dix minutes

Rien dans votre projet n'a besoin d'accepter du trafic entrant. C'est Cloud Monitoring qui fait la requête sortante.

## Étape 1 — Créer un canal qui sonne

Dans Echobell, créez un canal et réglez son type de notification sur **Appel**. Un canal d'appel se comporte comme un appel entrant plutôt que comme un push, il occupe donc tout l'écran et sonne. En mode Concentration d'iOS ou Ne pas déranger, il ne sonne que si vos réglages de Concentration laissent passer les appels.

Ouvrez les **Paramètres avancés** du canal et activez **Modèle personnalisé**. Cloud Monitoring enveloppe tout dans un objet `incident`, les modèles lisent donc des champs imbriqués :

```
Titre : {{incident.state}}: {{incident.policy_name}}
Corps : {{incident.summary}}
```

Définissez le **modèle de lien** pour qu'un appui sur la notification ouvre l'incident dans la console Google Cloud :

```
{{incident.url}}
```

Ajoutez une **condition** pour que seuls les incidents tout juste ouverts sonnent :

```
incident.state == "open"
```

Copiez l'URL du webhook du canal depuis sa vue détaillée :

```
https://hook.echobell.one/t/<channel-token>
```

## Étape 2 — Ajouter un canal de notification webhook dans Google Cloud

1. Ouvrez **Monitoring → Alerting** et cliquez sur **Edit notification channels**
2. Sous **Webhooks**, cliquez sur **Add new**
3. **Endpoint URL** : l'URL de votre canal Echobell de l'étape 1
4. **Display name** : `Echobell (call)`
5. Laissez **Use HTTP Basic Auth** désactivé
6. Cliquez sur **Test connection**, puis sur **Save**

Laissez Basic Auth désactivé exprès. L'échange Basic Auth de Google attend que l'endpoint réponde à la première requête par un `401` et un en-tête `WWW-Authenticate` ; Echobell s'authentifie plutôt par le jeton secret contenu dans l'URL, alors traitez cette URL comme un mot de passe.

Si vous gérez vos canaux avec Terraform, le même canal s'écrit :

```hcl
resource "google_monitoring_notification_channel" "echobell_call" {
  display_name = "Echobell (call)"
  type         = "webhook_tokenauth"

  labels = {
    url = "https://hook.echobell.one/t/<channel-token>"
  }
}
```

Gardez le jeton hors du contrôle de version : lisez-le depuis une variable ou Secret Manager plutôt que de committer l'URL.

## Étape 3 — Rattacher le canal aux règles qui méritent un appel

Ouvrez une règle d'alerte, allez dans **Notifications and name** et ajoutez `Echobell (call)` sous **Notification channels**. Une règle peut notifier plusieurs canaux à la fois, gardez donc votre canal e-mail ou Slack à côté.

Soyez sélectif. C'est le vrai filtre : un canal rattaché uniquement à « l'API de production est en panne » et « la base de données n'a plus de disque » sonne assez rarement pour que vous décrochiez encore. Laissez « CPU au-dessus de 70 % pendant cinq minutes » sur l'e-mail.

Deux réglages de la même page déterminent ce qui arrive sur votre téléphone :

- **Notify on incident closure.** S'il est activé, Cloud Monitoring envoie aussi une notification à la fermeture de l'incident. La condition `incident.state == "open"` de l'étape 1 empêche celle-ci de sonner ; l'étape 6 montre comment la recevoir discrètement.
- **Incident autoclose duration.** Si la métrique cesse de remonter des données, les incidents ouverts se ferment au bout de ce délai. Gardez la valeur par défaut, sauf raison particulière.

## Étape 4 — Savoir à quoi ressemble vraiment le payload

Cloud Monitoring envoie par défaut la version 1.2 du schéma. Réduit aux champs que vous utiliserez probablement, un incident ouvert ressemble à ceci :

```json
{
  "version": "1.2",
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "my-project",
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.opqiw61fsv7p?project=my-project",
    "state": "open",
    "renotify": false,
    "started_at": 1794713564,
    "ended_at": null,
    "policy_name": "Prod API 5xx rate",
    "condition_name": "5xx ratio above 5%",
    "resource_display_name": "prod-api",
    "threshold_value": "0.05",
    "observed_value": "0.183",
    "severity": "Critical",
    "policy_user_labels": {
      "team": "payments"
    },
    "documentation": {
      "content": "Check the latest deploy first. Runbook: https://wiki.example.com/api-5xx",
      "mime_type": "text/markdown"
    },
    "summary": "5xx ratio for prod-api with metric labels {response_code_class=500} is above the threshold of 0.050 with a value of 0.183."
  }
}
```

À savoir avant de modifier un modèle :

- **Tout se trouve sous `incident`.** `{{policy_name}}` s'affiche vide ; `{{incident.policy_name}}`, non.
- **`state` vaut `open` ou `closed`.** C'est sur ce seul champ que reposent la condition et le modèle de titre.
- **`summary` est un texte généré.** Google ne garantit pas son format, affichez-le donc, mais ne le testez pas dans une condition.
- **Des champs peuvent manquer.** Google précise que certains champs sont absents ou null selon la règle et l'état de l'incident. Dans Echobell, un champ manquant s'affiche comme une chaîne vide, le modèle continue donc de fonctionner ; évitez simplement de bâtir une condition sur un champ que vos règles ne renseignent pas.
- **`documentation.content` vous appartient.** Ce que vous tapez dans la zone **Documentation** de la règle arrive ici. Une consigne d'une ligne (« Vérifiez d'abord le dernier déploiement ») est plus utile sur un téléphone qui sonne que le résumé généré.
- **La gravité suit la règle.** C'est le niveau que vous avez défini sur la règle. Envoyez-vous un incident de test et vérifiez la valeur exacte avant de filtrer dessus.

Un corps qui commence par vos propres mots et se rabat sur le résumé :

```
{{incident.documentation.content}}
{{incident.summary}}
```

## Étape 5 — Décider de ce qui sonne, et à quelle fréquence

L'essentiel du filtrage a déjà eu lieu quand vous avez choisi les règles qui reçoivent le canal. La condition du canal Echobell s'occupe du reste.

| Objectif | Condition |
| --- | --- |
| Sonner uniquement à l'ouverture d'un incident | `incident.state == "open"` |
| Sonner une fois, pas à chaque rappel | `incident.state == "open" && !incident.renotify` |
| Sonner uniquement pour les règles d'une équipe | `incident.state == "open" && incident.policy_user_labels.team == "payments"` |
| Sonner uniquement la nuit (00:00–07:00 UTC) | `incident.state == "open" && hour < 7` |

**Rappels.** Une règle peut renvoyer des notifications tant qu'un incident reste ouvert : dans l'API, c'est `alertStrategy.notificationChannelStrategy[].renotifyInterval`, entre 30 minutes et 24 heures. Ces répétitions arrivent avec `renotify: true`. Les faire sonner ou non est un choix : sonner à nouveau est une escalade rudimentaire mais efficace pour un incident que personne n'a réglé, et les ignorer évite qu'une longue panne sonne toute la nuit. La deuxième ligne du tableau les ignore.

**Libellés utilisateur.** Les libellés utilisateur de la règle, comme `team: payments`, voyagent dans `policy_user_labels`. Une condition sur ces libellés permet à un canal rattaché à de nombreuses règles de sonner pour certaines et de rester muet pour les autres. Ils filtrent, ils ne routent pas : chaque URL de webhook déclenche toujours le même canal Echobell, donc un libellé ne peut pas envoyer un incident vers le canal de quelqu'un d'autre.

Les variables de temps d'Echobell sont en UTC : convertissez donc d'abord depuis votre fuseau. La [référence des conditions](/fr/docs/conditions) donne la liste de toutes les variables.

## Étape 6 — Une porte plus discrète pour les fermetures

Avec **Notify on incident closure** activé, un incident fermé est une bonne nouvelle à voir, pas une raison de sonner. Créez un second canal Echobell de type **Sensible au temps** (ou normal) avec les mêmes modèles et sans condition, ajoutez-le dans Google Cloud comme second canal webhook, et rattachez les deux à la règle. Le modèle de titre se lit déjà « closed: Prod API 5xx rate ».

| Canal Echobell | Condition | Type de canal | Comportement |
| --- | --- | --- | --- |
| `gcp-call` | `incident.state == "open"` | Appel | Sonne comme un appel entrant |
| `gcp-log` | aucune | Sensible au temps ou Normal | Chaque ouverture, rappel et fermeture, sans sonner |

## Testez avant de faire confiance

**Testez d'abord le côté Echobell.** Envoyez un payload calqué sur celui de Cloud Monitoring :

```bash
curl -X POST https://hook.echobell.one/t/<channel-token> \
  -H 'Content-Type: application/json' \
  -d '{"version":"1.2","incident":{"state":"open","renotify":false,"policy_name":"Manual test","summary":"Testing the Echobell path","url":"https://console.cloud.google.com/monitoring/alerting"}}'
```

**Testez ensuite le côté Google.** Le bouton **Test connection** envoie un payload d'exemple dont les champs ne correspondent pas à un vrai incident, il peut donc ne pas satisfaire votre condition. Pour un test de bout en bout, créez une règle jetable avec un seuil que vous dépassez déjà — par exemple, l'utilisation CPU de la VM au-dessus de 1 % —, rattachez-y `Echobell (call)`, attendez qu'elle se déclenche, puis supprimez la règle.

Si le `curl` sonne et que la vraie règle ne sonne pas, le problème est du côté de Google — le canal n'est pas rattaché, la condition n'a pas encore été remplie pendant sa durée, ou l'URL de l'endpoint a été mal copiée —, pas dans le canal Echobell.

## Alertes basées sur les journaux et tests de disponibilité

- **Les tests de disponibilité** ne préviennent personne par eux-mêmes ; ils alimentent une règle d'alerte. Créez la règle depuis le test de disponibilité et rattachez-y le même canal webhook.
- **Les règles d'alerte basées sur les journaux** ne notifient qu'à l'ouverture d'un incident — Google n'envoie pas de notification de fermeture pour elles — et exigent une limite de fréquence des notifications, qui plafonne la fréquence à laquelle une ligne de journal bruyante peut vous faire sonner. La condition `incident.state == "open"` fonctionne toujours ; le canal des fermetures n'entend simplement jamais parler de ces règles.

## Les limites qui comptent pendant un incident

- **Corps de 1 MiB.** Echobell rejette avec un HTTP 413 les corps de déclencheur de plus de 1 MiB. Un incident Cloud Monitoring pèse quelques kilo-octets.
- **120 requêtes par minute et par jeton.** Au-delà, le déclencheur répond `429` avec `RATE_LIMIT_EXCEEDED` et un `Retry-After`. Une seule règle en approche rarement, mais des dizaines de règles qui se déclenchent en même temps lors d'une panne régionale peuvent y arriver — une raison de plus de garder une liste courte sur le canal d'appel.
- **1500 octets de corps de notification.** Les rendus plus longs sont tronqués. Gardez la documentation de la règle courte, ou mettez-y le lien vers le runbook plutôt que le runbook lui-même.

## Ce que cette configuration ne vous donne pas

- **Pas d'acquittement.** Décrocher n'acquitte ni ne ferme l'incident dans Google Cloud.
- **Pas d'escalade ni de rotation.** Tous les abonnés du canal sont appelés ; personne n'est appelé ensuite.
- **Pas de déduplication au-delà de l'incident.** Une condition instable ouvre un nouvel incident à chaque fois, et chacun sonne. Corrigez-le sur la règle avec une fenêtre de durée plus longue.

Si c'est rédhibitoire, il vous faut une plateforme d'astreinte complète. Si votre besoin est « appelle-moi quand la règle de production se déclenche », c'est l'affaire de deux écrans dans la console.

## Dépannage

**L'incident s'est ouvert mais rien n'est arrivé.** Ouvrez l'incident dans **Monitoring → Alerting** et vérifiez que la règle liste le canal webhook. Assurez-vous que l'URL de l'endpoint est l'URL Echobell complète, jeton compris.

**La notification est arrivée mais n'a pas sonné.** Le type de canal n'est pas **Appel**, ou les réglages de Concentration de votre téléphone ne laissent pas passer les appels. Vérifiez le canal et votre configuration de Concentration.

**La notification est vide.** Le modèle lit des champs de premier niveau. Préfixez-les par `incident.` — `{{incident.policy_name}}`, pas `{{policy_name}}`.

**Ça sonne à nouveau toutes les demi-heures.** La règle a un intervalle de renotification. Supprimez-le, ou ajoutez `!incident.renotify` à la condition.

**Ça sonne quand l'incident se ferme.** Il manque `incident.state == "open"` dans la condition, ou elle est sur le mauvais canal.

## Questions fréquentes

### Google Cloud Monitoring peut-il appeler un numéro de téléphone nativement ?

Non. Les canaux de notification sont l'e-mail, le SMS, l'application mobile Google Cloud, Slack, Google Chat, PagerDuty, Pub/Sub et les webhooks. Un appel vocal exige un service externe : une plateforme d'astreinte, ou un webhook d'appel comme Echobell.

### Ai-je besoin de Pub/Sub ou d'une Cloud Function ?

Non. Cloud Monitoring publie lui-même l'incident sur l'URL du webhook. Pub/Sub est la recommandation de Google pour les endpoints non publics ; l'endpoint d'Echobell est public, le canal webhook suffit donc.

### Une alerte Cloud Monitoring traverse-t-elle Ne pas déranger ?

Seulement si elle arrive comme alerte de type appel. Un canal Echobell de type appel se comporte comme un appel entrant, que le mode Concentration et Ne pas déranger d'iOS laissent passer quand vos réglages de Concentration autorisent les appels. Un SMS ou un push ordinaire, non. Activez aussi **Réessayer l'appel échoué** : avec « Autoriser les appels répétés » activé dans vos réglages de Concentration, un second appel dans les trois minutes peut sonner.

### Faut-il utiliser l'option Basic Auth du webhook ?

Non. Echobell s'authentifie par le jeton de l'URL. Le flux Basic Auth de Google attend d'abord un challenge `401`, qu'Echobell n'envoie pas.

### Puis-je appeler des personnes différentes selon la règle ?

Oui. Créez un canal Echobell par public, ajoutez l'URL de chaque canal dans Google Cloud comme canal webhook distinct, et rattachez chacun aux règles dont ce public a la charge. Une URL de webhook déclenche toujours le même canal Echobell : une condition sur `policy_user_labels` peut donc rendre certaines règles muettes sur ce canal, mais pas les confier à un autre. Il n'y a pas d'acquittement, donc tous les abonnés en mode « appel » sont appelés.

### Et avec plusieurs projets ?

Un canal de notification appartient à un seul projet. Créez le canal webhook dans chaque projet — la même URL Echobell fonctionne partout — ou alertez depuis un projet de champ d'application qui surveille les autres.

## Pour finir

Le chemin tient en quatre parties : un canal d'appel avec une condition `incident.state == "open"`, un canal de notification webhook pointé vers lui, une courte liste de règles qui méritent un appel, et un vrai test avant de vous y fier. Le reste consiste à garder cette liste assez courte pour que, dans un mois, une sonnerie veuille encore dire quelque chose.

[Téléchargez Echobell pour iPhone](https://apps.apple.com/app/apple-store/id6743597198?pt=128151925&ct=blog-google-cloud-monitoring-phone-call-alerts-fr&mt=8) ou [obtenez-le sur Google Play](https://play.google.com/store/apps/details?id=one.echobell.echobellandroid), puis pointez-y votre règle d'alerte la plus importante.

## Articles connexes

- [Référence des conditions de canal](/fr/docs/conditions)
- [Référence des modèles](/fr/docs/template)
- [Guide d'intégration des webhooks](/fr/docs/webhook)
- [Alertes CloudWatch par appel](/fr/blog/cloudwatch-alarm-phone-call-alerts)
- [Alertes Alertmanager par appel](/fr/blog/alertmanager-phone-call-alerts)
- [Guide du développeur contre la fatigue des alertes](/fr/blog/fix-alert-fatigue-developer-guide)
- [Contourner le mode Concentration d'iOS pour les alertes critiques](/fr/blog/how-to-bypass-ios-focus-mode-for-critical-alerts)
