Créer et gérer des canaux de notification

Ce document explique comment configurer des canaux de notification en utilisant la console Google Cloud. Cloud Monitoring utilise ces canaux pour vous avertir, ou votre équipe d'astreinte, lorsqu'une règle d'alerte se déclenche. Lorsque vous créez une règle d'alerte, vous sélectionnez les personnes à avertir en effectuant des choix dans la liste des canaux de notification configurés. Par exemple, vous pouvez configurer des règles d'alerte qui surveillent les instances Compute Engine pour publier sujet Pub/Sub et pour informer le canal Slack de l'équipe d'astreinte.

Pour en savoir plus, consultez les sections Latence de notification et Notifications par incident

Ce document explique comment utiliser la console Google Cloud. Si vous utilisez l'API Cloud Monitoring, consultez la section Créer et gérer des canaux de notification avec l'API.

Avant de commencer

Pour obtenir les autorisations nécessaires pour afficher et configurer les canaux de notification à l'aide de la console Google Cloud, demandez à votre administrateur de vous accorder le Éditeur Monitoring (roles/monitoring.editor) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Pour en savoir plus sur les rôles Cloud Monitoring, consultez la section Contrôler les accès avec Identity and Access Management.

Créer un canal de notification

Lorsque vous créez une règle d'alerte, vous pouvez sélectionner n'importe quel canal de notification configuré et l'ajouter à votre règle. Vous pouvez préconfigurer vos canaux de notification, ou les configurer dans le cadre de la création d'une règle d'alerte. Pour plus d'informations, consultez l'article Créer une chaîne à la demande.

Pour créer un canal de notification à l'aide de la console Google Cloud, suivez les instructions propres au canal figurant dans le tableau suivant :

E-mail

Pour ajouter un canal de notification par e-mail, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Alertes :

    Accéder à l'interface des alertes

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  2. Cliquez sur Modifier les canaux de notification.
  3. Dans la section E-mail, cliquez sur Nouveau.
  4. Saisissez une seule adresse e-mail et une description.
  5. Cliquez sur Enregistrer.

Si vous utilisez une adresse e-mail de groupe comme canal de notification pour une règle d'alerte, configurez le groupe pour qu'il accepte les e-mails provenant de alerting-noreply@google.com.

Vous pouvez créer des canaux de notification par e-mail lors de la création d'une règle d'alerte. Pour en savoir plus, consultez la section Créer un canal à la demande.

Application mobile

Utilisez l'application mobile de la console Google Cloud pour surveiller votre Ressources de la console Google Cloud et Monitoring des informations depuis n'importe où. Les notifications de l'application mobile Google Cloud Console sont envoyées à un appareil spécifique ou à un utilisateur spécifique :

Liste des canaux de notification de l'application mobile de la console Google Cloud.

  • La valeur Device (Appareil) indique que les notifications ne sont envoyées que sur l'appareil spécifique qui a créé le canal de notification. Pour les canaux de notification à l'échelle de l'appareil, le champ Display name (Nom à afficher) inclut les informations sur l'appareil.
  • La valeur User (Utilisateur) indique que les notifications sont envoyées à tous les appareils sur lesquels l'application mobile Google Cloud Console est installée.

Cloud Monitoring détermine le champ d'application des notifications lors de la création du canal. Vous ne pouvez ni sélectionner, ni modifier le champ d'application.

Pour configurer un canal de notification de l'application mobile de la console Google Cloud pour un Google Cloud, procédez comme suit:

  1. Installez l'application mobile Google Cloud Console depuis la plate-forme de téléchargement d'applications de votre appareil mobile.
  2. Sélectionnez un projet à afficher dans l'application mobile de la console Google Cloud.

    Une fois le projet sélectionné, un échange de données entre l'application et le projet Google Cloud sélectionné se produit. Un canal de notification est créé lorsqu'il n'en existe aucun. Au bout de quelques minutes, il est répertorié dans la section Appareils mobiles de la page Canaux de notification.

Pour ajouter votre appareil mobile comme canal de notification pour une alerte : , dans la section Notifications d'alerte, sélectionnez Console Google Cloud (mobile), puis sélectionnez votre appareil mobile dans la liste.

PagerDuty

PagerDuty prend en charge la synchronisation bidirectionnelle avec Monitoring. Par conséquent, les affirmations suivantes sont vraies :

  • Lorsqu'un incident est créé dans Monitoring, un incident miroir est également ouvert dans PagerDuty.
  • Vous ne pouvez pas utiliser PagerDuty pour fermer un incident de Monitoring.
  • Si vous résolvez un incident dans PagerDuty et si Monitoring a ouvert l'incident, est rouverte dans PagerDuty.

Pour configurer les notifications PagerDuty, effectuer les opérations suivantes:

  1. Dans votre compte PagerDuty, configurez l'intégration dans un nouveau service ou ajoutez-la à un service existant.
    1. Créez un compte ou connectez-vous à un compte existant.
    2. Accédez à la page Services.
      • Pour créer un service, procédez comme suit:
        1. Cliquez sur + Nouveau service.
        2. Saisissez le nom et la description du service, puis cliquez sur Suivant.
        3. Configurez une règle d'escalade, puis cliquez sur Suivant.
        4. Si votre compte PagerDuty est compatible avec le regroupement d'alertes et les alertes temporaires, configurez-les, puis cliquez sur Suivant.
        5. Sur la page de configuration des intégrations, dans la section Rechercher un Dans la barre d'outils des intégrations, saisissez Events API v1, puis cliquez sur Créer un service. Vous êtes ensuite redirigé vers le panneau Integrations (Intégrations) de votre nouveau service.
      • Pour modifier un service existant, procédez comme suit:
        1. Sélectionnez un service dans votre répertoire de services.
        2. Sur la page de votre service, sélectionnez le panneau Intégrations.
        3. Cliquez sur + Ajouter une autre intégration pour accéder aux intégrations. page de configuration.
        4. Sur la page de configuration des intégrations, dans la section Rechercher un Dans la barre d'outils des intégrations, saisissez Events API v1, puis cliquez sur Ajouter. Vous êtes ensuite redirigé vers le panneau Intégrations de votre service modifié.
    3. Dans le panneau Integrations (Intégrations) du service, recherchez la liste de vos Nouvelle intégration, développez son menu, puis copiez la clé d'intégration.
  2. Dans Cloud Monitoring, ajoutez le canal de notification PagerDuty :
    1. Dans la console Google Cloud, accédez à la page Alertes :

      Accéder à l'interface des alertes

      Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

    2. Cliquez sur Modifier les canaux de notification.
    3. Dans la section PagerDuty, cliquez sur Nouveau.
    4. Saisissez le Display Name (Nom à afficher). Ce nom doit correspondre à celui du service PagerDuty dans lequel vous avez configuré votre nouvelle intégration à l'étape 1.
    5. Collez la clé d'intégration que vous avez copiée à l'étape 1 dans le champ Clé de service.
    6. Cliquez sur Enregistrer.

Lorsque vous créez une règle d'alerte, sélectionnez PagerDuty dans la section Notifications et choisissez votre configuration PagerDuty.

Le paquet JSON pour PagerDuty est au format suivant:

 {
     "description": A string of various fields in the incident,
     "details": JSON payload with schema version 1.2.
 }

Pour afficher un exemple et le schéma du champ details, procédez comme suit : développer les sections suivantes.

Règlement d'obsolescence

Le schéma de la charge utile est soumis au règlement Google Cloud sur l'abandon décrit dans la section 1.4(d) des Conditions d'utilisation de Google Cloud Platform. Notez que le schéma ne contrôle pas les formats des valeurs des champs générés, et ces formats peuvent être modifiés sans préavis. Par exemple, incident.summary, incident.documentation.content et incident.url sont censés inclure des données concernant leurs champs, mais le schéma ne comporte pas de contraintes pour garantir une analyse précise de ces champs. Vous pouvez consommer la valeur dans son ensemble et s'attendre à ce qu'elle respecte mais ne vous fiez pas à l'analyse des champs générés.

SMS

Pour configurer les notifications par SMS, procédez comme suit :

  1. Dans la console Google Cloud, accédez à la page Alertes :

    Accéder à l'interface des alertes

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  2. Cliquez sur Modifier les canaux de notification.
  3. Dans la section SMS, cliquez sur Nouveau.
  4. Renseignez la boîte de dialogue, puis cliquez sur Enregistrer.

Lorsque vous configurez votre règle d'alerte, sélectionnez le type de notification SMS et choisissez un numéro de téléphone validé dans la liste.

Slack

L'intégration de Monitoring avec Slack permet à vos règles d'alerte de publier des données sur un canal Slack lorsqu'un incident est créé. Pour configurer les notifications Slack, procédez comme suit :

  1. Dans Slack : créez un espace de travail et un canal Slack sur le site Slack. Enregistrez l'URL du canal.

  2. Dans la console Google Cloud, accédez à la page Alertes :

    Accéder à l'interface des alertes

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  3. Cliquez sur Modifier les canaux de notification.

  4. Dans la section Slack, cliquez sur Nouveau pour ouvrir la page de connexion Slack :

    1. Sélectionnez votre espace de travail Slack.
    2. Cliquez sur Autoriser pour autoriser Cloud Monitoring à accéder à votre espace de travail Slack. Cette action vous renvoie à la page de configuration Monitoring de votre canal de notification.
    3. Dans le champ Nom du canal Slack, saisissez le nom du canal Slack que vous souhaitez utiliser pour les notifications.
    4. Dans le champ Cloud Alerting Display Name (Nom à afficher pour les alertes Cloud), saisissez une courte déclaration descriptive. Monitoring affiche la valeur de ce champ sur la page Canal de notifications.
    5. (Facultatif) Pour tester la connexion entre Cloud Monitoring et votre espace de travail Slack, cliquez sur Envoyez une notification de test. Si la connexion aboutit, le message This is a test alert notification... s'affiche dans le canal de notification Slack que vous avez spécifié. Consultez le canal de notification pour confirmer la réception.
  5. Si le canal Slack que vous souhaitez utiliser pour les notifications est un chaîne privée, vous devez inviter manuellement Application de surveillance au canal:

    1. Ouvrez Slack.
    2. Accédez au canal que vous avez spécifié en tant que canal de notification Monitoring.

    3. Invitez l'application Monitoring sur le canal en en saisissant et en envoyant le message suivant dans le canal:

      /invite @Google Cloud Monitoring

      Veillez à inviter l'application Monitoring à accéder au que vous avez spécifié lors de la création du canal de notification Surveillance. L'invitation de l'application Monitoring aux canaux publics est facultative.

    Lorsque vous créez une règle d'alerte, sélectionnez Slack dans la section Notifications et choisissez votre configuration Slack.

Webhooks

Pour configurer les notifications par webhook, procédez comme suit :

  1. Gestionnaire de webhooks : identifiez l'URL du point de terminaison public qui recevra les données de webhooks de Monitoring.
  2. Dans la console Google Cloud, accédez à la page Alertes :

    Accéder à l'interface des alertes

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  3. Cliquez sur Modifier les canaux de notification.
  4. Dans la section Webhook, cliquez sur Add new (Ajouter).
  5. Complétez la boîte de dialogue.
  6. Cliquez sur Tester la connexion pour envoyer une charge utile de test au point de terminaison du Webhook. Vous pouvez accéder au point de terminaison de réception pour vérifier la distribution.
  7. Cliquez sur Enregistrer.

Lorsque vous créez une règle d'alerte, sélectionnez Webhook dans la section Notifications et choisissez votre configuration Webhook. Les notifications envoyées par Error Reporting suivent le schéma 1.0, tandis que les notifications envoyées par Monitoring suivent le schéma 1.2 :

Authentification de base

En plus de la requête de webhook, Cloud Monitoring envoie le nom d'utilisateur et le mot de passe conformément à la spécification HTTP de l'authentification de base. Cloud Monitoring exige que votre serveur renvoie une réponse 401 avec l'en-tête WWW-Authenticate approprié. Pour plus d'informations sur l'authentification de base, consultez les ressources suivantes :

Authentification par jeton

L'authentification par jeton nécessite un paramètre de chaîne de requête dans l'URL du point de terminaison et une clé que le s'attend à être secret entre lui-même et Monitoring. Vous trouverez ci-dessous un exemple d'URL incluant un jeton :

https://www.myserver.com/stackdriver-hook?auth_token=1234-abcd

Si Monitoring publie un incident sur l'URL du point de terminaison, votre serveur peut valider le jeton associé. Cette méthode de l'authentification est plus efficace lorsqu'elle est utilisée avec SSL/TLS pour chiffrer la requête HTTP et empêcher les pirates d'apprendre le jeton.

Pour obtenir un exemple de serveur en Python, consultez cet exemple de serveur.

Règlement d'obsolescence

Le schéma de charge utile est soumis au règlement d'obsolescence de Google Cloud décrit à la section 1.4(d) des Conditions d'utilisation de Google Cloud Platform. Notez que le schéma ne contrôle pas les formats des valeurs des champs générés, et ces formats peuvent être modifiés sans préavis. Par exemple, incident.summary, incident.documentation.content et incident.url sont censés inclure des données concernant leurs champs, mais le schéma ne comporte pas de contraintes pour garantir une analyse précise de ces champs. Vous pouvez utiliser la valeur dans son ensemble et vous attendre à ce qu'elle respecte le règlement d'abandon, mais ne vous appuyez pas sur l'analyse des champs générés.

Pub/Sub

Cette section explique comment configurer les canaux de notification Pub/Sub. À des fins de redondance, nous vous recommandons de créer plusieurs canaux de notification. Associer Pub/Sub à l'application mobile de la console Google Cloud Nous vous recommandons d'utiliser PagerDuty, Webhooks ou Slack, car Pub/Sub utilise un mécanisme de distribution différent.

Pour configurer un canal de notification Pub/Sub:

  1. Activer les API requises et créer un sujet
  2. Configurer le canal de notification pour un sujet
  3. Autoriser un compte de service
  4. Définir le canal de notification dans une règle d'alerte

Pour comprendre le schéma de données, consultez Exemple de schéma.

Pour recevoir les notifications d'alerte, vous devez également créer l'un des abonnements suivants: pull, push ou BigQuery.

Lorsque l'abonnement se trouve dans un projet différent du sujet, créez un compte de service dans le projet de l'abonné et attribuez-lui le rôle roles/pubsub.subscriber.

Avant de commencer

Lorsque vous ajoutez le premier canal de notification Pub/Sub à une projet Google Cloud, Cloud Monitoring crée un compte de service pour ce projet. Il attribue aussi le rôle Identity and Access Management Agent de service Monitoring Notification au compte de service. Ce compte de service permet à Monitoring d'envoyer des notifications vers les canaux de notification Pub/Sub de ce projet.

Le compte de service a le format suivant :

service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com

Le nom du compte de service de notifications inclut un numéro unique de projet Google Cloud. Vous pouvez trouver le nom, l'ID et le numéro du projet sur le tableau de bord du projet dans la console Google Cloud, ou les récupérer à l'aide de la commande suivante :

gcloud projects describe PROJECT_ID --format="value(project_number)"

Vous pouvez afficher et modifier le compte de service à l'aide du la console Google Cloud ou la Google Cloud CLI.

Activer les API requises et créer un sujet

Dans le projet Google Cloud dans lequel vous prévoyez de créer le canal de notification et Pub/Sub, procédez comme suit:

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Pub/Sub and Cloud Monitoring APIs.

    Enable the APIs

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Pub/Sub and Cloud Monitoring APIs.

    Enable the APIs

  8. Créer un sujet Pub/Sub Pour en savoir plus sur la création d'un sujet, consultez la section Créer un sujet. Par exemple, pour créer un sujet nommé notificationTopic à l'aide de Google Cloud CLI, exécutez la commande suivante :

    gcloud pubsub topics create notificationTopic

Configurez ensuite vos canaux de notification Pub/Sub.

Configurer les notifications pour un sujet

Pour créer un canal de notification Pub/Sub, vous pouvez utiliser l'API Monitoring, Google Cloud CLI ou la console Google Cloud. Après avoir créé la notification d'autorisation, autorisez le compte de service des notifications chaque sujet que vous utilisez comme canal de notification.

Pour en savoir plus sur l'utilisation de l'API Monitoring ou Google Cloud CLI pour créer le canal de notification, consultez Créer des chaînes

Pour utiliser la console Google Cloud afin de créer le canal de notification, procédez comme suit :

  1. Dans la console Google Cloud, accédez à la page Alertes :

    Accéder à l'interface des alertes

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  2. Sélectionnez le projet Google Cloud contenant le sujet Pub/Sub que vous avez créé.
  3. Cliquez sur Modifier les canaux de notification.
  4. Dans la section Pub/Sub, cliquez sur Nouveau.

    La boîte de dialogue Canal Pub/Sub créé affiche le nom du compte de service créé par Monitoring.

  5. Autorisez le compte de service. Votre compte de service peut publier Tous les thèmes ou sujets spécifiques:

    • Pour publier tous les sujets, sélectionnez Gérer les rôles, puis ajoutez le rôle Éditeur Pub/Sub.

      Une fois que vous avez terminé de configurer le canal de notification, ignorez la section suivante intitulée Autoriser le compte de service et passez à la section Définir le canal de notification dans une règle d'alerte.

    • Pour publier des sujets spécifiques, passez à l'étape suivante et autorisez le compte de service à publier des sujets spécifiques une fois la configuration du canal de notification terminée. Instructions pour autoriser le compte de service, consultez Autorisez le compte de service.
  6. Saisissez le nom à afficher de votre chaîne, puis le Nom du sujet Pub/Sub.
  7. (Facultatif) Pour vérifier que le canal est correctement configuré, cliquez sur Envoyer une notification de test.
  8. Sélectionnez Ajouter un canal.

Autorisez ensuite le compte de service.

Autoriser le compte de service

L'autorisation permet au compte de service de notifications de publier chaque sujet Pub/Sub que vous utilisez comme canal de notification. Cette section décrit comment effectuer les opérations suivantes:

  • Autorisez un compte de service pour un sujet spécifique.
  • Autorisez un compte de service pour tous les sujets.

Autoriser un compte de service pour un sujet spécifique

Vous pouvez autoriser un compte de service à publier un sujet spécifique à l'aide de la console Google Cloud et de la Google Cloud CLI. Cette section décrit les deux approches.

Pour autoriser votre compte de service pour un sujet spécifique en utilisant la console Google Cloud, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page Sujets:

    Accéder à Sujets

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Pub/Sub :

  2. Sélectionnez le sujet.
  3. Dans l'onglet Autorisations, sélectionnez Ajouter un compte principal.
  4. Dans le champ Nouveau compte principal, saisissez le nom du compte de service de notifications. Le compte de service suit la convention d'attribution de noms suivante :
    service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com
  5. Sélectionnez le rôle Éditeur Pub/Sub, puis Enregistrer.

Pour autoriser votre compte de service pour un sujet spécifique à l'aide de Google Cloud CLI, attribuez-lui le rôle IAM pubsub.publisher correspondant au sujet. Par exemple, la commande suivante configure le Rôle IAM pour le sujet notificationTopic:

gcloud pubsub topics add-iam-policy-binding \
projects/PROJECT_NUMBER/topics/notificationTopic --role=roles/pubsub.publisher \
--member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com
 

Réponse à une exécution réussie de la La commande add-iam-policy-binding se présente comme suit:

 Updated IAM policy for topic [notificationTopic].
 bindings:
 ‐ members:
    ‐ serviceAccount:service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com
    role: roles/pubsub.publisher
 etag: BwWcDOIw1Pc=
 version: 1
 

Pour en savoir plus, consultez la page de référence sur pubsub topics add-iam-policy-binding.

Autoriser un compte de service pour tous les sujets

Pour autoriser votre compte de service pour tous les sujets, procédez comme suit:

  1. Dans la console Google Cloud, accédez à la page IAM :

    Accéder à IAM

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est IAM et administration.

  2. Sélectionnez Inclure les attributions de rôles fournies par Google, comme illustré dans l'image suivante :
    Sélectionnez l'option "Inclure les attributions de rôles fournies par Google".
  3. Recherchez le compte de service au format suivant :
    service-PROJECT_NUMBER@gcp-sa-monitoring-notification.iam.gserviceaccount.com

    Actualisez la page si le compte de service n'est pas listé.

  4. Sélectionnez Modifier pour le service de notifications sélectionnez Ajouter un autre rôle, puis ajoutez le rôle Éditeur Pub/Sub.

Ensuite, définissez le canal de notification dans une règle d'alerte.

Définir le canal de notification dans une règle d'alerte

Pour utiliser un canal de notification Pub/Sub dans une règle d'alerte, sélectionnez Pub/Sub comme type de canal, puis sélectionnez le sujet.

Exemple de schéma

Pour afficher un exemple de paquet JSON et le schéma, développez les sections suivantes.

Règlement d'obsolescence

Le schéma de la charge utile est soumis au règlement Google Cloud sur l'abandon décrit dans la section 1.4(d) des Conditions d'utilisation de Google Cloud Platform. Notez que le schéma ne contrôle pas les formats des valeurs de champ générées, et que ces formats peuvent être modifiés sans préavis. Par exemple, incident.summary, incident.documentation.content et incident.url sont censés inclure des données concernant leurs champs, mais le schéma ne comporte pas de contraintes pour garantir une analyse précise de ces champs. Vous pouvez consommer la valeur dans son ensemble et s'attendre à ce qu'elle respecte mais ne vous fiez pas à l'analyse des champs générés.

Google Chat

L'application Google Cloud Monitoring permet à vos espaces Google Chat de : recevoir des notifications.

Avant de commencer

Si vous faites partie d'une organisation, vous devez disposer d'un accès à l'application Google Cloud Monitoring pour l'installer. Si vous n'y avez pas accès, demandez à un administrateur Google Workspace de procéder comme suit :

  1. Ajoutez l'application à la liste d'autorisation des applications Marketplace et activez l'accès au niveau de l'unité organisationnelle racine.
  2. Configurez les paramètres d'installation des applications Marketplace de sorte que les utilisateurs puissent installer l'application.

Installer l'application Google Cloud Monitoring

Vous devez suivre la procédure ci-dessous pour installer l'application Google Cloud Monitoring. L'installation à partir de la fiche Google Workspace Marketplace n'est pas prise en charge.

Pour installer l'application et configurer un espace en tant que canal de notification, procédez comme suit:

  1. Dans Google Chat, ouvrez ou créez l'espace dans lequel vous souhaitez recevoir des notifications.

  2. Installez l'application Google Cloud Monitoring:

    1. Sélectionnez le nom de votre espace, puis Applications et intégrations.

    2. Si l'application Google Cloud Monitoring n'apparaît pas dans la liste des applications, puis revenez à votre espace, saisissez @Google Cloud Monitoring, puis appuyez sur Entrée.

    3. Cliquez sur Ajouter à l'espace.

  3. Copiez l'ID de l'espace Chat dans le presse-papiers.

    Si vous avez installé l'application Google Cloud Monitoring, l'espace Chat L'ID est inclus dans la confirmation d'installation. Sinon, vous pouvez trouver l'ID de l'espace Chat sous la forme d'une série de chiffres et de lettres après space/ à la fin de l'URL de l'espace Chat.

  4. Ouvrez un nouvel onglet de navigateur, puis configurez le canal de notification :

    1. Dans la console Google Cloud, accédez à la page Alertes :

      Accéder à l'interface des alertes

      Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

    2. Cliquez sur Modifier les canaux de notification.

    3. Accédez à la section Google Chat, puis cliquez sur Ajouter.

    4. Saisissez l'ID de votre espace Chat dans le champ ID de l'espace Chat, puis cliquez sur Enregistrer.

Créer un canal à la demande

Lorsque vous ajoutez un canal de notification à une règle d'alerte, vous devez sélectionner un canal dans une liste. Pour mettre à jour la liste des options lorsque vous créez une règle d'alerte, procédez comme suit :

  1. Dans la boîte de dialogue de notification, cliquez sur Manage Notification Channels (Gérer les canaux de notification). La fenêtre Canaux de notification s'ouvre dans une nouvelle onglet du navigateur.
  2. Pour ajouter un nouveau canal de notification, recherchez son type, cliquez sur Nouveau, puis suivez les instructions propres au canal figurant dans le tableau précédent.
  3. Revenez à l'onglet d'origine, puis dans la boîte de dialogue de notification, cliquez sur Actualiser.

    Boîte de dialogue de notification affichant les boutons d'actualisation et de gestion des canaux.

  4. Sélectionnez le canal de notification dans la liste actualisée.

Recevoir une notification sur une chaîne non prise en charge

Si le canal de notification de votre choix n'est pas pris en charge, envisagez de créer un pipeline qui repose sur l'envoi de vos notifications à Pub/Sub. Pour obtenir un exemple Python utilisant Flask, consultez la section Créer des notifications personnalisées avec Cloud Monitoring et Cloud Run. Pour obtenir d'autres exemples, consultez la dépôt Git cloud-alerting-notification-forwarding

Tester un canal de notification

Cloud Monitoring ne propose pas d'option de test pour les canaux de notification. Cependant, vous pouvez vérifier qu'un canal de notification est correctement configuré en créer une règle d'alerte et configurer la condition à remplir.

Pour tester manuellement vos canaux de notification, vous pouvez : créer une règle d'alerte qui surveille de l'utilisation du processeur de l'une de vos instances de machines virtuelles (VM) :

  1. (Facultatif) Si vous n'avez pas encore de VM dans votre projet Google Cloud ou si vous souhaitez pour utiliser une autre VM à des fins de test, puis créez une VM:

    1. Dans la console Google Cloud, accédez à la page Instances de VM :

      Accéder à la page Instances de VM

      Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Compute Engine.

    2. Sélectionnez Créer une instance, puis configurez votre VM. Pour en savoir plus sur la création de VM, consultez la page Créer une instance de VM à partir d'une image publique.
  2. Dans la console Google Cloud, accédez à la page Alertes :

    Accéder à l'interface des alertes

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  3. Sélectionnez Créer une règle.

  4. Utilisez le menu Sélectionner une métrique pour sélectionner la métrique Utilisation du processeur pour une instance de VM.

  5. Cliquez sur Ajouter un filtre, puis ajoutez un filtre pour votre VM.

  6. Mettez à jour les champs Configurer le déclencheur comme suit:

    1. Sélectionnez En dessous du seuil pour le champ Position du seuil.
    2. Sélectionnez une valeur supérieure à l'utilisation du processeur pour votre Compute Engine. Par exemple, si le graphique indique que l'utilisation du processeur est d'environ 5 %, définissez le seuil sur 10 %.

      Ces paramètres configurent la condition à remplir lorsque l'utilisation du processeur d'une instance de VM est inférieure au seuil spécifié. Parce que vous sélectionné un seuil supérieur à l'utilisation du processeur instance de VM, la condition de la règle d'alerte est remplie.

  7. Ajoutez les canaux de notification à votre règle.

  8. Développez Délai pour la fermeture automatique de l'incident et sélectionnez 30 min.

  9. Saisissez un nom de règle, puis cliquez sur Créer une règle.

  10. Une fois la condition remplie, vérifiez que vous avez reçu une notification sur chaque canal de notification.

  11. Supprimez la règle d'alerte. L'incident est automatiquement fermé une fois la durée de fermeture automatique écoulée.

  12. Si vous avez créé une instance de VM pour ce test, supprimez-la.

Si vous ne recevez pas les notifications attendues, vous pouvez rechercher dans l'explorateur de journaux des entrées de journal contenant des informations sur les notifications manquantes. Pour en savoir plus, consultez la section Les notifications ne sont pas reçues.

Modifier et supprimer des canaux de notification

Pour modifier ou supprimer un canal de notification à l'aide de la console Google Cloud, procédez comme suit :

  1. Dans la console Google Cloud, accédez à la page Alertes :

    Accéder à l'interface des alertes

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  2. Cliquez sur Modifier les canaux de notification.

    Le tableau de bord des canaux de notification contient une section pour chaque type de canal de notification. Chaque section répertorie toutes les configurations pour ce type :

    • Pour modifier une entrée, cliquez sur Modifier. Cliquez sur Enregistrer une fois les modifications effectuées.
    • Pour supprimer une entrée, cliquez sur  Supprimer. Cliquez sur Supprimer dans la boîte de dialogue de confirmation.

Afficher les journaux des canaux de notification

Vous pouvez utiliser l'explorateur de journaux pour afficher les erreurs des canaux de notification:

  1. Dans la console Google Cloud, accédez à la page Explorateur de journaux.

    Accéder à l'explorateur de journaux

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.

  2. Saisissez et exécutez votre requête. Pour les requêtes spécifiques aux erreurs de canal de notification, consultez la section Requêtes Cloud Monitoring.

Étape suivante

Pour en savoir plus sur les incidents, consultez les documents suivants :