Créer et gérer des canaux de notification

Ce document explique comment configurer des canaux de notification à l'aide de la console Google Cloud. Cloud Monitoring utilise ces canaux pour vous avertir, vous 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 à informer 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 un sujet Pub/Sub et notifier le canal Slack pour l'équipe d'astreinte.

Pour en savoir plus, consultez les sections Latence des notifications et Notifications par incident.

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

Remarque :Les données envoyées aux destinataires des chaînes peuvent contenir des informations sensibles. Examinez vos pratiques réglementaires avant de créer le canal de notification.

Avant de commencer

Pour obtenir les autorisations dont vous avez besoin pour afficher et configurer les canaux de notification à l'aide de la console Google Cloud, demandez à votre administrateur de vous attribuer le rôle IAM Éditeur Monitoring (roles/monitoring.editor) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

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 page 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 en savoir plus, consultez Créer une chaîne à la demande.

Remarque :Nous vous recommandons de créer plusieurs canaux de notification à des fins de redondance. Google n'a aucun contrôle sur un grand nombre de systèmes de livraison après leur avoir transmis la notification. En outre, un seul service Google est compatible avec Cloud Mobile App, PagerDuty, les webhooks et Slack. Si vous utilisez l'un de ces canaux de notification, utilisez les e-mails, les SMS ou Pub/Sub comme canal redondant.

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

E-mail

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

1. Dans le panneau de navigation de la console Google Cloud, sélectionnez Monitoring, puis  Alertes :

   Accéder à l'interface des alertes

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 [e-mail].

Vous pouvez créer des canaux de messagerie lors de la création d'une règle d'alerte. Pour en savoir plus, consultez Créer une chaîne à la demande.

Application pour mobile

Utilisez l'application mobile de la console Google Cloud pour surveiller les ressources et les informations de Monitoring de la console Google Cloud, où que vous soyez. Les notifications de l'application mobile de la console Google Cloud sont envoyées à un appareil ou à un utilisateur spécifiques:

• 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.
• User (Utilisateur) indique que les notifications sont envoyées à tous les appareils sur lesquels l'application mobile de la console Google Cloud 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 projet Google Cloud spécifique, procédez comme suit:

1. Installez l'application mobile de la console Google Cloud 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 en tant que canal de notification pour une règle d'alerte, dans la section Notifications d'alerte, sélectionnez Console Google Cloud (mobile), puis choisissez votre appareil mobile dans la liste.

PagerDuty

L'intégration à PagerDuty permet une synchronisation unidirectionnelle ou bidirectionnelle avec Monitoring. Indépendamment de votre configuration, les conditions suivantes s'appliquent :

• 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 utilisez la synchronisation unidirectionnelle et que vous résolvez l'incident dans PagerDuty, l'état de l'incident dans PagerDuty est découplé de celui de Monitoring. En effet, si vous résolvez un incident dans PagerDuty, il est définitivement fermé dans PagerDuty et ne peut pas être rouvert.

Si vous utilisez la synchronisation bidirectionnelle, Monitoring contrôle l'état indiqué par PagerDuty. Si vous résolvez l'incident dans PagerDuty et que Monitoring l'ouvre, il est rouvert dans PagerDuty.

Pour configurer les notifications PagerDuty, procédez comme suit:

1. Dans votre compte PagerDuty, configurez l'intégration dans un nouveau service ou ajoutez l'intégration à 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 un nom et une description de service, puis cliquez sur Suivant.
     3. Configurez une règle d'escalade, puis cliquez sur Suivant.
     4. Si votre compte PagerDuty accepte le regroupement des alertes et les alertes temporaires, configurez-les, puis cliquez sur Suivant.
     5. Sur la page de configuration des intégrations, dans la barre d'outils Search for an integration(s) (Rechercher une ou plusieurs intégrations), saisissez Events API v1, puis cliquez sur Create service (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 annuaire de services.
     2. Sur la page du service, sélectionnez le panneau Integrations (Intégrations).
     3. Cliquez sur + Ajouter une autre intégration pour accéder à la page de configuration des intégrations.
     4. Sur la page de configuration des intégrations, dans la barre d'outils Search for an integration(s) (Rechercher une ou plusieurs intégrations), saisissez Events API v1, puis cliquez sur Add (Ajouter). Vous êtes ensuite redirigé vers le panneau Integrations (Intégrations) de votre service modifié.
   3. Dans le panneau Intégrations de votre service, recherchez la liste de votre 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 le panneau de navigation de la console Google Cloud, sélectionnez Monitoring, puis  Alertes :

      Accéder à l'interface des alertes

   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 au nom du service PagerDuty dans lequel vous avez configuré votre nouvelle intégration à l'étape 1.
   5. Saisissez la clé d'intégration que vous avez copiée à l'étape 1 dans le champ Clé de service.
   6. Cliquez sur Enregistrer.
3. Facultatif: si vous souhaitez configurer la synchronisation bidirectionnelle, procédez comme suit :
   1. Accédez à votre compte PagerDuty.
   2. Sélectionnez Services, puis le nom du service que vous avez saisi lors de la configuration de l'intégration.
   3. Sélectionnez le panneau Integrations (Intégrations) de votre service.
   4. Accédez à la section Paramètres d'alerte et d'incident, puis cliquez sur Modifier.
   5. Sélectionnez Créer des incidents et des alertes, puis enregistrez vos modifications.

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 a le 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, développez les sections suivantes.

Exemples JSON

Par défaut, le backend d'alerte tente de générer un paquet JSON au format 1.2. Pour en savoir plus sur cette mise en forme, consultez la section suivante.

Voici un exemple de ce type de paquet :

{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown"
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}
       

Structure du schéma, version 1.2

Cette section décrit la version 1.2 du schéma de charge utile. Certains champs peuvent ne pas apparaître dans tous les paquets renvoyés ou présenter des valeurs vides, selon la configuration de la règle d'alerte, l'état de l'incident ou la ressource surveillée. Certains champs utilisent des structures intégrées en tant que valeurs. Ces structures sont décrites par référence, car leur contenu peut également varier.

Dans un paquet renvoyé, les champs peuvent apparaître dans n'importe quel ordre. Dans la description qui suit, ils sont organisés en groupes connexes.

{
  "version": "1.2",
  "incident": {
    
    Informations sur l'incident
    
    "incident_id" : chaîne, ID généré pour cet incident.
    "scoping_project_id" : chaîne, ID du projet qui héberge le champ d'application des métriques.
    "scoping_project_number" : numéro, qui correspond au numéro du projet effectuant une surveillance.
    "url" : chaîne, URL de la console Google Cloud pour cet incident.
    "started_at" : nombre, heure (en secondes de l'epoch Unix) d'ouverture de l'incident.
    "ended_at" : nombre, heure (en secondes au format Unix) de fermeture de l'incident. Renseigné uniquement lorsque state est défini sur closed.
    "state" : chaîne, état de l'incident: open ou closed. Si la valeur est open, alors ended_at est nul.
    "summary" : chaîne, résumé textuel généré de l'incident
    "apigee_url" : chaîne, URL Apigee pour cet incident, uniquement pour les types de ressources Apigee Environment et Proxy*.
    "observed_value" : chaîne (la valeur observée qui a déclenché/résolu l'alerte) peut être vide si la condition a expiré.
    
    Informations sur la ressource surveillée pour laquelle l'incident a été ouvert.
    
    "resource": {
      "type" : chaîne, identifiant du type de ressource surveillée sur lequel l'alerte est envoyée (par exemple, gce_instance). Consultez la section Liste des ressources surveillées.
      "labels" : objet, paires clé/valeur pour les étiquettes associées à la ressource surveillée.
    },
    "resource_type_display_name" : chaîne, nom à afficher pour le type de ressource surveillée.
    "resource_id" : chaîne, ID d'instance de la ressource surveillée, même valeur que resource.labels.instance_id.
    "resource_display_name" : chaîne, nom à afficher de la ressource surveillée.
    "resource_name" : chaîne, nom généré pour la ressource surveillée ; comprend les valeurs d'autres champs.
    
    Informations sur le type de métrique associé aux données de la série temporelle.
    
    "metric": {
      "type" : chaîne, identifiant du type de métrique sur lequel l'alerte est envoyée (par exemple, compute.googleapis.com/instance/cpu/utilization). Consultez la section Liste de métriques.
      "displayName" : chaîne, nom à afficher du type de métrique.
      "labels" : objet, paires clé/valeur pour les libellés associés à la métrique.
    },
    "metadata": {
      "system_labels" : objet, paires clé/valeur pour les libellés de métadonnées système.
      "user_labels" : objet, paires clé/valeur pour les libellés de métadonnées utilisateur
    },
    
    Informations sur la règle d'alerte et la condition ayant ouvert/résolu l'incident.
    Les valeurs sont issues de l'objet AlertPolicy approprié.
    
    "policy_name" : chaîne, nom à afficher pour la règle d'alerte.
    "policy_user_labels" : objet, paires clé/valeur pour tous les libellés utilisateur associés à la règle.
    "documentation" : objet, une structure intégrée au format Documentation.
    "condition" : objet, une structure intégrée au format Condition.
    "condition_name" : chaîne, nom à afficher de la condition, même valeur que condition.displayName.
    "severity" : chaîne, niveau de gravité des incidents. Si ce champ n'est pas défini lors de la création de la règle d'alerte, Cloud Monitoring définit le niveau de gravité de la règle d'alerte sur No Severity.
    "threshold_value" : chaîne, qui correspond à la valeur de seuil de cette condition, peut être vide si la condition n'est pas une condition de seuil.
  },
}

Règlement relatif aux abandons

Le schéma de charge utile est soumis au règlement relatif aux abandons de Google Cloud 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 présente aucune contrainte 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 relatif aux abandons, 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 le panneau de navigation de la console Google Cloud, sélectionnez Monitoring, puis  Alertes :

   Accéder à l'interface des alertes

2. Cliquez sur Modifier les canaux de notification.
3. Dans la section SMS, cliquez sur Ajouter.
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

Remarque :Pour effectuer ces étapes, vous devez être propriétaire ou administrateur d'un espace de travail Slack. Pour en savoir plus, consultez Gérer les demandes d'invitation.

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 le panneau de navigation de la console Google Cloud, sélectionnez Monitoring, puis  Alertes :

   Accéder à l'interface des alertes

3. Cliquez sur Modifier les canaux de notification.

4. Dans la section Slack, cliquez sur Ajouter 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 Nom à afficher pour les alertes cloud, saisissez une brève instruction 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 Envoyer une notification de test. Si la connexion est établie, un 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 canal privé, vous devez inviter manuellement l'application Monitoring à rejoindre le 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 à accéder au canal en saisissant et en envoyant le message suivant sur le canal:

      /invite @Google Cloud Monitoring

      Veillez à inviter l'application Monitoring sur le canal privé que vous avez spécifié lors de la création du canal de notification dans Monitoring. 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

Remarque:Les webhooks ne sont compatibles qu'avec les points de terminaison publics. Si vous avez besoin que des notifications soient envoyées à un point de terminaison non public, créez un canal de notification Pub/Sub et configurez un abonnement au sujet Pub/Sub. Pour en savoir plus, consultez la section Les notifications de webhook échouent lorsqu'elles sont configurées pour un point de terminaison privé.

Remarque:Si une fonction Cloud est configurée comme point de terminaison de webhook pour un canal de notification, assurez-vous que l'utilisateur qui appelle la fonction dispose de l'autorisation d'authentification requise. Pour en savoir plus, consultez les pages Authentifier une fonction pour les appels de fonction et Activer l'accès à une fonction.

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 le panneau de navigation de la console Google Cloud, sélectionnez Monitoring, puis  Alertes :

   Accéder à l'interface des alertes

3. Cliquez sur Modifier les canaux de notification.
4. Dans la section Webhook, cliquez sur 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 destinataire 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 celles envoyées par Monitoring suivent le schéma 1.2:

Exemples JSON

Par défaut, le backend d'alerte tente de générer un paquet JSON au format 1.2. Pour en savoir plus sur cette mise en forme, consultez la section suivante.

Voici un exemple de ce type de paquet :

{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown"
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}
       

Structure du schéma, version 1.2

Cette section décrit la version 1.2 du schéma de charge utile. Certains champs peuvent ne pas apparaître dans tous les paquets renvoyés ou présenter des valeurs vides, selon la configuration de la règle d'alerte, l'état de l'incident ou la ressource surveillée. Certains champs utilisent des structures intégrées en tant que valeurs. Ces structures sont décrites par référence, car leur contenu peut également varier.

Dans un paquet renvoyé, les champs peuvent apparaître dans n'importe quel ordre. Dans la description qui suit, ils sont organisés en groupes connexes.

{
  "version": "1.2",
  "incident": {
    
    Informations sur l'incident
    
    "incident_id" : chaîne, ID généré pour cet incident.
    "scoping_project_id" : chaîne, ID du projet qui héberge le champ d'application des métriques.
    "scoping_project_number" : numéro, qui correspond au numéro du projet effectuant une surveillance.
    "url" : chaîne, URL de la console Google Cloud pour cet incident.
    "started_at" : nombre, heure (en secondes de l'epoch Unix) d'ouverture de l'incident.
    "ended_at" : nombre, heure (en secondes au format Unix) de fermeture de l'incident. Renseigné uniquement lorsque state est défini sur closed.
    "state" : chaîne, état de l'incident: open ou closed. Si la valeur est open, alors ended_at est nul.
    "summary" : chaîne, résumé textuel généré de l'incident
    "apigee_url" : chaîne, URL Apigee pour cet incident, uniquement pour les types de ressources Apigee Environment et Proxy*.
    "observed_value" : chaîne (la valeur observée qui a déclenché/résolu l'alerte) peut être vide si la condition a expiré.
    
    Informations sur la ressource surveillée pour laquelle l'incident a été ouvert.
    
    "resource": {
      "type" : chaîne, identifiant du type de ressource surveillée sur lequel l'alerte est envoyée (par exemple, gce_instance). Consultez la section Liste des ressources surveillées.
      "labels" : objet, paires clé/valeur pour les étiquettes associées à la ressource surveillée.
    },
    "resource_type_display_name" : chaîne, nom à afficher pour le type de ressource surveillée.
    "resource_id" : chaîne, ID d'instance de la ressource surveillée, même valeur que resource.labels.instance_id.
    "resource_display_name" : chaîne, nom à afficher de la ressource surveillée.
    "resource_name" : chaîne, nom généré pour la ressource surveillée ; comprend les valeurs d'autres champs.
    
    Informations sur le type de métrique associé aux données de la série temporelle.
    
    "metric": {
      "type" : chaîne, identifiant du type de métrique sur lequel l'alerte est envoyée (par exemple, compute.googleapis.com/instance/cpu/utilization). Consultez la section Liste de métriques.
      "displayName" : chaîne, nom à afficher du type de métrique.
      "labels" : objet, paires clé/valeur pour les libellés associés à la métrique.
    },
    "metadata": {
      "system_labels" : objet, paires clé/valeur pour les libellés de métadonnées système.
      "user_labels" : objet, paires clé/valeur pour les libellés de métadonnées utilisateur
    },
    
    Informations sur la règle d'alerte et la condition ayant ouvert/résolu l'incident.
    Les valeurs sont issues de l'objet AlertPolicy approprié.
    
    "policy_name" : chaîne, nom à afficher pour la règle d'alerte.
    "policy_user_labels" : objet, paires clé/valeur pour tous les libellés utilisateur associés à la règle.
    "documentation" : objet, une structure intégrée au format Documentation.
    "condition" : objet, une structure intégrée au format Condition.
    "condition_name" : chaîne, nom à afficher de la condition, même valeur que condition.displayName.
    "severity" : chaîne, niveau de gravité des incidents. Si ce champ n'est pas défini lors de la création de la règle d'alerte, Cloud Monitoring définit le niveau de gravité de la règle d'alerte sur No Severity.
    "threshold_value" : chaîne, qui correspond à la valeur de seuil de cette condition, peut être vide si la condition n'est pas une condition de seuil.
  },
}

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 :

• Spécification RFC
• Authentification de base

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, ainsi qu'une clé que le serveur s'attend à être secrète 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 d'authentification est plus efficace lorsqu'elle est utilisée avec SSL/TLS pour chiffrer la requête HTTP, empêchant ainsi les pirates informatiques d'apprendre le jeton.

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

Règlement relatif aux abandons

Le schéma de charge utile est soumis au règlement relatif aux abandons de Google Cloud 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 présente aucune contrainte 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 relatif aux abandons, mais ne vous fiez pas à 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. Il est recommandé d'associer Pub/Sub à l'application mobile de la console Google Cloud, PagerDuty, les webhooks ou Slack, car Pub/Sub utilise un mécanisme de distribution différent.

Pour configurer un canal de notification Pub/Sub, procédez comme suit:

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 la section 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 de celui du sujet, créez un compte de service dans le projet abonné et attribuez-lui le rôle roles/pubsub.subscriber.

Avant de commencer

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

Le compte de service a le format suivant :

[e-mail]

Le nom du compte de service de notifications inclut un numéro de projet Google Cloud unique. Vous pouvez trouver le nom, l'ID et le numéro du projet dans son tableau de bord dans la console Google Cloud. Vous pouvez également le 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 de la console Google Cloud ou de 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 le sujet Pub/Sub, procédez comme suit:

1. Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.

2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder au sélecteur de projet

3. Vérifiez que la facturation est activée pour votre projet Google Cloud.

4. Activer les API Pub/Sub and Cloud Monitoring.

   Activer les API

5. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder au sélecteur de projet

6. Vérifiez que la facturation est activée pour votre projet Google Cloud.

7. Activer les API Pub/Sub and Cloud Monitoring.

   Activer les API

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 appelé notificationTopic à l'aide de la Google Cloud CLI, exécutez la commande suivante:

   gcloud pubsub topics create notificationTopic

Remarque :Si vous envisagez de créer votre canal de notification et votre sujet Pub/Sub dans différents projets Google Cloud, assurez-vous d'activer les API Pub/Sub et Monitoring dans les deux projets.

Configurez ensuite vos canaux de notification Pub/Sub.

Configurer des notifications pour un thème

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éé le canal de notification, autorisez le compte de service de notifications à publier chaque sujet que vous utilisez en tant que canal de notification.

Pour en savoir plus sur l'utilisation de l'API Monitoring ou de la Google Cloud CLI pour créer le canal de notification, consultez la section Créer des canaux.

Pour créer le canal de notification à l'aide de la console Google Cloud, procédez comme suit:

1. Dans le panneau de navigation de la console Google Cloud, sélectionnez Monitoring, puis  Alertes :

   Accéder à l'interface des alertes

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 Created Pub/Sub Channel (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 sujets ou des sujets spécifiques:

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

     Après avoir effectué ces étapes pour 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. Pour savoir comment autoriser le compte de service, consultez la section Autoriser un compte de service.
6. Saisissez un nom à afficher pour votre canal et le nom du sujet Pub/Sub.
7. (Facultatif) Pour vérifier que le canal est correctement configuré, cliquez sur Envoyer une notification test.
8. Sélectionnez Ajouter un canal.

Ensuite, autorisez le compte de service.

Autoriser le compte de service

Remarque :Effectuez cette étape lorsque vous créez le canal de notification à l'aide de l'API ou de Google Cloud CLI, et lorsque vous avez ignoré l'étape d'autorisation lorsque vous utilisez la console Google Cloud.

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 Google Cloud CLI. Cette section décrit les deux approches.

Pour autoriser votre compte de service pour un sujet spécifique à l'aide de la console Google Cloud, procédez comme suit:

1. Dans le panneau de navigation de la console Google Cloud, sélectionnez Pub/Sub, puis Sujets:

   Accédez à Topics.

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 utilise la convention d'attribution de noms suivante:

   [e-mail]

5. Sélectionnez le rôle Éditeur Pub/Sub, puis sélectionnez Enregistrer.

Pour autoriser votre compte de service pour un sujet spécifique à l'aide de la Google Cloud CLI, attribuez au compte de service le rôle IAM pubsub.publisher pour le 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:[e-mail]
 

Une réponse à l'exécution réussie de la commande add-iam-policy-binding se présente comme suit:

 Updated IAM policy for topic [notificationTopic].
 bindings:
 ‐ members:
    ‐ serviceAccount:[e-mail]
    role: roles/pubsub.publisher
 etag: BwWcDOIw1Pc=
 version: 1
 

Pour en savoir plus, consultez la page de référence 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 le panneau de navigation de la console Google Cloud, sélectionnez IAM :

   Accéder à IAM

2. Sélectionnez Inclure les attributions de rôles fournies par Google, comme illustré dans l'image suivante:
   
3. Recherchez le compte de service au format suivant:

   [e-mail]

   Actualisez la page lorsque le compte de service ne figure pas dans la liste.

4. Sélectionnez Modifier pour le compte de 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 le sujet.

Exemple de schéma

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

Exemples JSON

Par défaut, le backend d'alerte tente de générer un paquet JSON au format 1.2. Pour en savoir plus sur cette mise en forme, consultez la section suivante.

Voici un exemple de ce type de paquet :

{
  "incident": {
    "incident_id": "0.opqiw61fsv7p",
    "scoping_project_id": "internal-project",
    "scoping_project_number": 12345,
    "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project",
    "started_at": 1577840461,
    "ended_at": 1577877071,
    "state": "closed",
    "resource_id": "11223344",
    "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3",
    "resource_type_display_name": "VM Instance",
    "resource": {
      "type": "gce_instance",
      "labels": {
        "instance_id": "11223344",
        "project_id": "internal-project",
        "zone": "us-central1-c"
      }
    },
    "metric": {
      "type": "compute.googleapis.com/instance/cpu/utilization",
      "displayName": "CPU utilization",
      "labels": {
        "instance_name": "the name of the VM instance"
      }
    },
    "metadata": {
      "system_labels": { "labelkey": "labelvalue" },
      "user_labels": { "labelkey": "labelvalue" }
    },
    "policy_name": "Monitor-Project-Cluster",
    "policy_user_labels" : {
        "user-label-1" : "important label",
        "user-label-2" : "another label"
    },
    "condition_name": "VM Instance - CPU utilization [MAX]",
    "threshold_value": "0.9",
    "observed_value": "0.835",
    "condition": {
      "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789",
      "displayName": "VM Instance - CPU utilization [MAX]",
      "conditionThreshold": {
        "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"",
        "aggregations": [
          {
            "alignmentPeriod": "120s",
            "perSeriesAligner": "ALIGN_MEAN"
          }
        ],
        "comparison": "COMPARISON_GT",
        "thresholdValue": 0.9,
        "duration": "0s",
        "trigger": {
          "count": 1
        }
      }
    },
    "documentation": {
      "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n",
      "mime_type": "text/markdown"
    },
    "summary": "CPU utilization for internal-project gke-cluster-1-16-default-pool-e2df4cbd-dgp3 with metric labels {instance_name=gke-cluster-1-default-pool-e2df4cbd-dgp3} and system labels {state=ACTIVE} returned to normal with a value of 0.835."
  },
  "version": "1.2"
}
       

Structure du schéma, version 1.2

Cette section décrit la version 1.2 du schéma de charge utile. Certains champs peuvent ne pas apparaître dans tous les paquets renvoyés ou présenter des valeurs vides, selon la configuration de la règle d'alerte, l'état de l'incident ou la ressource surveillée. Certains champs utilisent des structures intégrées en tant que valeurs. Ces structures sont décrites par référence, car leur contenu peut également varier.

Dans un paquet renvoyé, les champs peuvent apparaître dans n'importe quel ordre. Dans la description qui suit, ils sont organisés en groupes connexes.

{
  "version": "1.2",
  "incident": {
    
    Informations sur l'incident
    
    "incident_id" : chaîne, ID généré pour cet incident.
    "scoping_project_id" : chaîne, ID du projet qui héberge le champ d'application des métriques.
    "scoping_project_number" : numéro, qui correspond au numéro du projet effectuant une surveillance.
    "url" : chaîne, URL de la console Google Cloud pour cet incident.
    "started_at" : nombre, heure (en secondes de l'epoch Unix) d'ouverture de l'incident.
    "ended_at" : nombre, heure (en secondes au format Unix) de fermeture de l'incident. Renseigné uniquement lorsque state est défini sur closed.
    "state" : chaîne, état de l'incident: open ou closed. Si la valeur est open, alors ended_at est nul.
    "summary" : chaîne, résumé textuel généré de l'incident
    "apigee_url" : chaîne, URL Apigee pour cet incident, uniquement pour les types de ressources Apigee Environment et Proxy*.
    "observed_value" : chaîne (la valeur observée qui a déclenché/résolu l'alerte) peut être vide si la condition a expiré.
    
    Informations sur la ressource surveillée pour laquelle l'incident a été ouvert.
    
    "resource": {
      "type" : chaîne, identifiant du type de ressource surveillée sur lequel l'alerte est envoyée (par exemple, gce_instance). Consultez la section Liste des ressources surveillées.
      "labels" : objet, paires clé/valeur pour les étiquettes associées à la ressource surveillée.
    },
    "resource_type_display_name" : chaîne, nom à afficher pour le type de ressource surveillée.
    "resource_id" : chaîne, ID d'instance de la ressource surveillée, même valeur que resource.labels.instance_id.
    "resource_display_name" : chaîne, nom à afficher de la ressource surveillée.
    "resource_name" : chaîne, nom généré pour la ressource surveillée ; comprend les valeurs d'autres champs.
    
    Informations sur le type de métrique associé aux données de la série temporelle.
    
    "metric": {
      "type" : chaîne, identifiant du type de métrique sur lequel l'alerte est envoyée (par exemple, compute.googleapis.com/instance/cpu/utilization). Consultez la section Liste de métriques.
      "displayName" : chaîne, nom à afficher du type de métrique.
      "labels" : objet, paires clé/valeur pour les libellés associés à la métrique.
    },
    "metadata": {
      "system_labels" : objet, paires clé/valeur pour les libellés de métadonnées système.
      "user_labels" : objet, paires clé/valeur pour les libellés de métadonnées utilisateur
    },
    
    Informations sur la règle d'alerte et la condition ayant ouvert/résolu l'incident.
    Les valeurs sont issues de l'objet AlertPolicy approprié.
    
    "policy_name" : chaîne, nom à afficher pour la règle d'alerte.
    "policy_user_labels" : objet, paires clé/valeur pour tous les libellés utilisateur associés à la règle.
    "documentation" : objet, une structure intégrée au format Documentation.
    "condition" : objet, une structure intégrée au format Condition.
    "condition_name" : chaîne, nom à afficher de la condition, même valeur que condition.displayName.
    "severity" : chaîne, niveau de gravité des incidents. Si ce champ n'est pas défini lors de la création de la règle d'alerte, Cloud Monitoring définit le niveau de gravité de la règle d'alerte sur No Severity.
    "threshold_value" : chaîne, qui correspond à la valeur de seuil de cette condition, peut être vide si la condition n'est pas une condition de seuil.
  },
}

Règlement relatif aux abandons

Le schéma de charge utile est soumis au règlement relatif aux abandons de Google Cloud 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 présente aucune contrainte 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 relatif aux abandons, mais ne vous fiez pas à l'analyse des champs générés.

Google Chat

Preview

Ce produit ou cette fonctionnalité est soumis aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent bénéficier d'une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

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

Avant de commencer

Si vous êtes dans une organisation, vous devez avoir accès à l'application Google Cloud Monitoring pour installer l'application Google Cloud Monitoring. Si ce n'est pas le cas, demandez à un administrateur Google Workspace d'effectuer les opérations suivantes:

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 par les utilisateurs afin qu'ils 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. Il n'est pas possible de procéder à l'installation à partir de la fiche Google Workspace Marketplace.

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 ne figure pas dans la liste des applications, revenez dans 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 votre presse-papiers.

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

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

   1. Dans le panneau de navigation de la console Google Cloud, sélectionnez Monitoring, puis  Alertes :

      Accéder à l'interface des alertes

   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.

Remarque :Vous ne pouvez pas afficher ni gérer l'incident à l'aide de l'application Google Cloud Monitoring. Pour confirmer l'incident ou suspendre la règle d'alerte associée, utilisez la console Google Cloud, la Google Cloud CLI ou l'API Cloud Monitoring.

Créer une chaîne à 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 lors de la création d'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 un nouvel 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 et, dans la boîte de dialogue de notification, cliquez sur Refresh (Actualiser).

   

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

Recevoir une notification sur une chaîne non compatible

Si votre canal de notification préféré n'est pas compatible, 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 page Créer des notifications personnalisées avec Cloud Monitoring et Cloud Run. Pour d'autres exemples, consultez le dépôt Git "cloud-alerting-notification-forwarding".

Tester un canal de notification

Cloud Monitoring n'est pas compatible avec les options de test pour les canaux de notification. Toutefois, vous pouvez vérifier qu'un canal de notification est correctement configuré en créant une règle d'alerte et en configurant la condition à déclencher.

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

1. Dans le panneau de navigation de la console Google Cloud, sélectionnez Compute Engine, puis Instances de VM :

   Accéder à la page Instances de VM

2. Sélectionnez une instance de VM ou créez-en une.

3. Créez une règle d'alerte pour surveiller l'utilisation du processeur de cette instance.

   Si votre projet Google Cloud contient plusieurs instances, ajoutez un filtre pour en sélectionner une.

4. Configurez les champs Déclencheur de condition comme suit:

   1. Sélectionnez Seuil pour le champ Type de condition.
   2. Sélectionnez En dessous du seuil dans le champ Position du seuil.
   3. Sélectionnez une valeur supérieure à l'utilisation du processeur pour votre instance. Par exemple, si le graphique indique que l'utilisation du processeur est d'environ 5%, définissez le seuil sur 10%.
   4. Développez Advanced Options (Options avancées) et sélectionnez No retest (Aucun nouveau test) dans le champ Retest window (Fenêtre de nouveau test).

   Ces paramètres configurent la condition pour qu'elle se déclenche lorsque l'utilisation du processeur d'une instance de VM est inférieure au seuil spécifié. Comme vous avez sélectionné un seuil supérieur à l'utilisation du processeur de votre instance de VM, la condition se déclenche.

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

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

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

8. Une fois la condition déclenchée, vérifiez que vous avez reçu une notification sur chaque canal de notification.

9. Supprimez la règle d'alerte. L'incident est fermé automatiquement à l'expiration du délai de fermeture automatique.

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

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 le panneau de navigation de la console Google Cloud, sélectionnez Monitoring, puis  Alertes :

   Accéder à l'interface des alertes

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.

Remarque :Vous ne pouvez pas supprimer un canal de notification à l'aide de la console Google Cloud lorsque le canal est associé à une règle d'alerte. Toutefois, vous pouvez supprimer le canal à l'aide de Google Cloud CLI ou de l'API Cloud Monitoring. Pour en savoir plus, consultez Créer et gérer des canaux de notification à l'aide de l'API.

Afficher les journaux du canal de notification

Vous pouvez utiliser l'explorateur de journaux pour afficher les erreurs du canal de notification:

1. Dans le panneau de navigation de la console Google Cloud, sélectionnez Logging, puis Explorateur de journaux :

   Accéder à l'explorateur de journaux

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.

Étapes suivantes

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

• Incidents pour les règles d'alerte basées sur les métriques
• Incidents pour les règles d'alerte basées sur les journaux.