Alertes pour les règles d'alerte basées sur des métriques

Les alertes Cloud Monitoring vous permettent de suivre et d'examiner les problèmes lorsque les données de séries temporelles remplissent les conditions d'une règle d'alerte basée sur des métriques. Pour chaque alerte, Monitoring envoie une notification et crée une page Détails de l'alerte pour vous aider à résoudre le problème et à gérer le cycle de vie de l'alerte.

Sur la page Détails de l'alerte, vous pouvez consulter le calendrier des alertes, les graphiques des données de métriques surveillées, ainsi que les liens vers les alertes et les entrées de journal associées. Si une règle contient plusieurs conditions, elle indique si une alerte est déclenchée lorsqu'une seule condition est remplie. Monitoring ne crée pas d'alerte si la règle est mise en veille ou désactivée, ou si le nombre de règles d'alerte ou d'alertes dépasse les limites d'alerte.

Cette fonctionnalité n'est disponible que pour les projets Google Cloud . Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion.

Avant de commencer

Pour obtenir les autorisations nécessaires pour afficher et gérer les alertes, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

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

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

Afficher les alertes

Pour afficher les alertes dans votre projet, utilisez la console Google Cloud , la gcloud CLI ou l'API Monitoring.

Console Google Cloud

Pour lister les alertes dans votre projet Google Cloud  :

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

    Accéder à la page Alertes

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

  2. Dans la barre d'outils de la console Google Cloud , sélectionnez votre projet Google Cloud . Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion.

    La page Alertes affiche des informations sur vos règles d'alerte, vos mises en veille et vos alertes :

    • Le volet Résumé indique le nombre d'alertes ouvertes.
    • Le tableau Alertes affiche les alertes ouvertes les plus récentes. Pour afficher les alertes les plus récentes dans le tableau, y compris celles qui sont fermées, cliquez sur Afficher les alertes fermées.

  3. Pour afficher les détails d'une alerte spécifique, sélectionnez-la dans la liste.

    La page Détails de l'alerte s'ouvre. Pour en savoir plus sur la page Détails de l'alerte, consultez la section Examiner une alerte de ce document.

Rechercher d'anciennes alertes

Le tableau Alertes sur la page Alertes affiche les alertes ouvertes les plus récentes. Pour afficher les alertes plus anciennes, effectuez l'une des opérations suivantes :

  • Pour parcourir les entrées du tableau Alertes, cliquez sur  Plus récentes ou  Plus anciennes.

  • Pour ouvrir une page qui vous permet de lister et de filtrer vos alertes, cliquez sur Afficher toutes les alertes. La page Alertes s'ouvre. Sur cette page, procédez comme suit :

    • Afficher toutes les alertes, y compris celles qui sont fermées. Pour afficher toutes les alertes, cliquez sur Afficher les alertes fermées.
    • Filtrer les alertes. Pour savoir comment ajouter des filtres, consultez Filtrer les alertes.
    • Confirmer ou fermer une alerte, ou suspendre sa règle d'alerte Pour accéder à ces options, cliquez sur  Plus d'options sur la ligne de l'alerte, puis faites votre choix dans le menu. Pour en savoir plus, consultez Gérer les alertes.

Filtrer les alertes

Pour limiter les alertes affichées dans le tableau, ajoutez des filtres. Si vous ajoutez plusieurs filtres, le tableau n'affiche que les alertes qui répondent à tous les filtres.

Pour filtrer le tableau des alertes, procédez comme suit :

  1. Sur la page Alertes, cliquez sur  Filtrer le tableau, puis sélectionnez une propriété de filtre. Les propriétés de filtre incluent les suivantes :

    • État de l'alerte
    • Nom de la règle d'alerte
    • Date d'ouverture ou de fermeture de l'alerte
    • Type de métrique
    • Type de ressource

  2. Sélectionnez une valeur dans le menu secondaire ou saisissez-en une dans la barre de filtre.

    Par exemple, si vous sélectionnez Type de métrique et saisissez usage_time, seules les options suivantes peuvent s'afficher dans le menu secondaire:

    agent.googleapis.com/cpu/usage_time
compute.googleapis.com/guest/container/cpu/usage_time
container.googleapis.com/container/cpu/usage_time

    Le filtre est alors listé dans le tableau Alertes.

gcloud

Vous pouvez utiliser gcloud pour obtenir des alertes et les lister.

Recevoir une alerte

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • ALERT_NAME : nom de ressource de l'alerte. Exemple :projects/my-project/alerts/my-alert-id

Exécutez la commande gcloud alpha monitoring alerts describe  :

Linux, macOS ou Cloud Shell

gcloud alpha monitoring alerts describe ALERT_NAME

Windows (PowerShell)

gcloud alpha monitoring alerts describe ALERT_NAME

Windows (cmd.exe)

gcloud alpha monitoring alerts describe ALERT_NAME
 La commande renvoie une réponse contenant des informations sur l'alerte, telles que son état, les libellés associés et la règle d'alerte source. La réponse ressemble à ce qui suit : 
{
  "name": "projects/my-project/alerts/my-alert-id1",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "close_time": "2025-06-13T10:11:36Z",
  "resource": {
    "type": "gce_instance",
    "labels": {
      "zone": "us-west1",
      "instance_id": "123456789",
      "project_id": "my-project"
    }
  },
  "metric": {
    "labels": {
      "instance_name": "my-instance1"
    },
    "type": "compute.googleapis.com/instance/cpu/usage_time"
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "my-policy"
  },
  "summaryText": "[ALERT] VM Instance - CPU usage on my-project my-instance1"
}

Lister les alertes

Vous pouvez lister les alertes de votre projet et filtrer les résultats à l'aide de gcloud CLI.

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • PROJECT_ID : identifiant du projet.

Exécutez la commande gcloud alpha monitoring alerts list  :

Linux, macOS ou Cloud Shell

gcloud alpha monitoring alerts list

Windows (PowerShell)

gcloud alpha monitoring alerts list

Windows (cmd.exe)

gcloud alpha monitoring alerts list
 La commande renvoie une réponse contenant des informations sur l'alerte, telles que son état, les libellés associés et la règle d'alerte source. La réponse ressemble à ce qui suit : 
{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id1",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "close_time": "2025-06-13T10:11:36Z",
      "resource": {
        "type": "gce_instance",
        "labels": {
          "zone": "us-west1",
          "instance_id": "123456789",
          "project_id": "my-project"
        }
      },
      "metric": {
        "labels": {
          "instance_name": "my-instance1"
        },
        "type": "compute.googleapis.com/instance/cpu/usage_time"
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "my-policy"
      },
      "summaryText": "[ALERT] VM Instance - CPU usage on my-project my-instance1"
    }
  ]
}
Vous pouvez également utiliser les options facultatives suivantes pour filtrer, trier ou modifier le résultat :

  • --filter : fournissez une expression de filtre pour filtrer les alertes par heure ou par libellé. Par exemple, filtrez par heure avec --filter='close_time>="2025-09-10T00:00:00Z"' ou par libellé avec --filter='resource.labels.key="value"'.

  • --sort-by : liste de champs séparés par une virgule selon lesquels trier la sortie. Exemple : --sort-by=open_time.

  • --uri : la commande génère une liste d'URI de ressources au lieu du résultat par défaut.

  • --limit : définissez cette option sur 2 ou une valeur supérieure pour limiter le nombre d'alertes renvoyées. N'utilisez pas cette option conjointement avec l'option --filter.

API Monitoring

Vous pouvez utiliser l'API Monitoring pour obtenir des alertes et les lister.

Recevoir une alerte

Pour obtenir des informations sur une seule alerte avec l'API Monitoring, utilisez la méthode alerts.get.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : identifiant du projet.
  • ALERT_ID : ID de l'alerte.

Méthode HTTP et URL : 

GET https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts/ALERT_ID

Pour envoyer votre requête, développez l'une des options suivantes :

La commande renvoie une réponse contenant des informations sur l'alerte, telles que son état, les libellés associés et la règle d'alerte source. La réponse ressemble à ce qui suit : 
{
  "name": "projects/my-project/alerts/my-alert-id1",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "close_time": "2025-06-13T10:11:36Z",
  "resource": {
    "type": "gce_instance",
    "labels": {
      "zone": "us-west1",
      "instance_id": "123456789",
      "project_id": "my-project"
    }
  },
  "metric": {
    "labels": {
      "instance_name": "my-instance1"
    },
    "type": "compute.googleapis.com/instance/cpu/usage_time"
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "my-policy"
  },
  "summaryText": "[ALERT] VM Instance - CPU usage on my-project my-instance1"
}

Lister les alertes

Pour lister les alertes de votre projet et filtrer les résultats avec l'API Monitoring, utilisez la méthode alerts.list.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : identifiant du projet.

Méthode HTTP et URL : 

GET https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts

Pour envoyer votre requête, développez l'une des options suivantes :

La commande renvoie une réponse contenant des informations sur l'alerte, telles que son état, les libellés associés et la règle d'alerte source. La réponse ressemble à ce qui suit : 
{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id1",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "close_time": "2025-06-13T10:11:36Z",
      "resource": {
        "type": "gce_instance",
        "labels": {
          "zone": "us-west1",
          "instance_id": "123456789",
          "project_id": "my-project"
        }
      },
      "metric": {
        "labels": {
          "instance_name": "my-instance1"
        },
        "type": "compute.googleapis.com/instance/cpu/usage_time"
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "my-policy"
      },
      "summaryText": "[ALERT] VM Instance - CPU usage on my-project my-instance1"
    }
  ]
}
Les utilisateurs de Curl peuvent ajouter l'indicateur --data-urlencode suivi d'une expression de filtre pour filtrer les alertes par heure ou par libellé. Consultez les exemples suivants :

Lister les alertes ouvertes au cours de la dernière heure :

--data-urlencode "filter=(open_time>=\"`date -u -d "1 hour ago" +"%Y-%m-%dT%H:%M:%SZ"`\")"

Lister et filtrer les alertes ouvertes au cours des dernières 24 heures :

--data-urlencode "filter=(open_time>=\"`date -u -d "1 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\" AND state=open)"

Lister et filtrer les alertes ouvertes entre deux périodes :

--data-urlencode "filter=(open_time>=\"`date -u -d "2 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\" AND open_time<=\"`date -u -d "1 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\")"

Lister et filtrer les alertes par libellé utilisateur. Dans cet exemple, filtrez par libellé utilisateur avec le nom app et la valeur my-gke-app :

--data-urlencode "filter=(policy.user_labels.app=\"my-gke-app\")"
Les utilisateurs de Powershell peuvent utiliser l'exemple suivant pour ajouter un filtre temporel à l'URL de leur requête : 
$baseUrl = "https://monitoring.googleapis.com/v3/projects/my-project/alerts"
$filterValue = (Get-Date).AddHours(-1).ToString("yyyy-MM-ddTHH:mm:ssZ")
$filter = 'open_time >= "' + $filterValue + '"'
$encodedFilter = [System.Uri]::EscapeDataString($filter)
$url = $baseUrl + "?filter=" + $encodedFilter

Examiner une alerte

La page Détails de l'alerte contient des informations qui peuvent vous aider à identifier la cause d'une alerte.

Explorer les données de métriques

Pour analyser l'état de votre métrique avant et après le déclenchement de votre alerte, utilisez le graphique Métriques d'alerte. Ce graphique affiche une chronologie et les séries temporelles qui ont déclenché la condition de votre règle d'alerte.

Vous pouvez ajuster la plage de la chronologie pour rechercher des tendances et des modèles dans vos données de métriques par rapport à l'alerte :

  • Pour afficher uniquement les séries temporelles qui ont déclenché la condition ou toutes les séries temporelles évaluées par la condition, cliquez sur Afficher toutes les séries temporelles.

  • Pour modifier la période affichée par le graphique, vous pouvez utiliser le sélecteur de période dans la barre d'outils ou mettre en surbrillance des périodes sur le graphique avec votre pointeur.

Vous pouvez également analyser plus en détail vos données de métriques en les affichant dans l'explorateur de métriques. Pour ce faire, accédez au graphique Métriques d'alerte, puis cliquez sur Explorer les données. Par défaut, l'explorateur de métriques agrège et filtre les données de métriques afin que le graphique de métriques s'aligne sur la série temporelle affichée dans la chronologie Métriques d'alerte.

Explorer les entrées de journal

Le volet Journaux de la page Détails de l'alerte affiche les entrées de journal qui correspondent au type de ressource et aux libellés de la ressource surveillée pour votre métrique. Vous pouvez analyser ces entrées de journal pour trouver des informations supplémentaires qui pourraient vous aider à résoudre les problèmes liés à votre alerte.

  • Pour afficher les entrées de journal dans l'explorateur de journaux, cliquez sur Afficher dans l'explorateur de journaux, puis sélectionnez un projet de définition du champ d'application. L'explorateur de journaux fournit des outils supplémentaires pour analyser les données des entrée de journal, comme une chronologie de la création des entrées de journal associées.
  • Pour afficher et modifier la requête utilisée pour filtrer les entrées de journal dans l'explorateur de métriques, cliquez sur Explorer les données.

Afficher les informations sur l'application

Pour les règles d'alerte associées à une application App Hub, accédez à la section Associé à l'application. Une entrée de cette section liste l'ID application et fournit des liens vers un tableau de bord affichant des informations sur l'application. La deuxième entrée liste une charge de travail ou un service, et renvoie à un tableau de bord.

Afficher des informations supplémentaires

La section Libellés affiche les libellés et les valeurs de la ressource et de la métrique surveillées de la série temporelle qui a déclenché l'alerte, ainsi que les libellés utilisateur définis dans la règle d'alerte. Ces informations peuvent vous aider à identifier la ressource surveillée spécifique qui a déclenché l'alerte. Pour en savoir plus, consultez Annoter les alertes avec des libellés.

La section Documentation affiche le modèle de documentation pour les notifications que vous avez fournies lors de la création de la règle d'alerte. Ces informations peuvent inclure une description de ce que la règle d'alerte surveille, ainsi que des conseils pour atténuer le problème. Pour en savoir plus, consultez Annoter les notifications avec une documentation définie par l'utilisateur.

Si vous n'avez pas configuré de documentation pour votre règle d'alerte, le volet Documentation affiche le message "Aucune documentation n'est configurée".

Pour vous aider à identifier les problèmes sous-jacents dans votre application, vous pouvez explorer les alertes liées à d'autres conditions de règles d'alerte.

La section Alertes associées affiche la liste des alertes qui correspondent à l'un des critères suivants :

  • L'alerte a été créée lorsqu'une condition de la même règle d'alerte a été remplie.
  • L'alerte partage un libellé avec celle affichée sur la page Détails de l'alerte.

Gérer les alertes

Les alertes peuvent avoir l'un des états suivants :

  •  Ouvert : L'ensemble des conditions de la règle d'alerte sont remplies ou aucune donnée n'indique que les conditions ne sont plus remplies. Si une règle d'alerte contient plusieurs conditions, les alertes sont ouvertes en fonction de la manière dont ces conditions sont combinées. Pour en savoir plus, consultez Règles avec plusieurs conditions.

  •  Confirmée : l'alerte est ouverte et a été manuellement marquée comme confirmée. En général, cet état indique que l'alerte fait l'objet d'une enquête.

  •  Fermée : le système a constaté que la condition n'était plus remplie, vous avez fermé l'alerte ou sept jours se sont écoulés sans que la condition continue d'être remplie.

Lorsque vous configurez une règle d'alerte, assurez-vous que l'état stable fournit un signal lorsque tout va bien. Cela est nécessaire pour s'assurer que l'état sans erreur peut être identifié et, si une alerte est ouverte, pour que cette alerte soit fermée. Si aucun signal n'indique qu'une condition d'erreur a cessé, une fois l'alerte ouverte, elle reste ouverte pendant sept jours après le déclenchement de la règle d'alerte.

Par exemple, si vous créez une règle d'alerte qui vous avertit lorsque le nombre d'erreurs est supérieur à 0, assurez-vous qu'elle génère un nombre d'erreurs égal à 0 lorsqu'il n'y en a pas. Si la règle d'alerte renvoie une valeur nulle ou vide dans l'état sans erreur, aucun signal n'indique quand les erreurs ont cessé. Si nécessaire, PromQL vous permet de spécifier une valeur par défaut qui est utilisée lorsqu'aucune valeur mesurée n'est disponible.

Confirmer les alertes

Nous vous recommandons de marquer une alerte comme "Reçue" lorsque vous commencez à en examiner la cause.

Pour marquer une alerte comme reconnue :

  1. Dans le tableau Alertes de la page Alertes, cliquez sur Afficher toutes les alertes.

  2. Sur la page Alertes, recherchez l'alerte que vous souhaitez accuser réception, puis effectuez l'une des opérations suivantes :

    • Cliquez sur  Autres options, puis sélectionnez Confirmer.
    • Ouvrez la page d'informations de l'alerte, puis cliquez sur Accuser réception de l'alerte.

Si votre règle d'alerte est configurée pour envoyer des notifications répétées, l'accusé de réception d'une alerte n'arrête pas les notifications. Pour les arrêter, effectuez l'une des opérations suivantes :

  • Créez une mise en veille pour la règle d'alerte.
  • Désactivez la règle d'alerte.

Mettre en veille une règle d'alerte

Pour empêcher Monitoring de créer des alertes et d'envoyer des notifications pendant une période spécifique, mettez en veille la règle d'alerte associée. Lorsque vous mettez en veille une règle d'alerte, Monitoring ferme également toutes les alertes associées.

Pour créer une option de report pour une alerte que vous consultez :

  1. Sur la page Détails de l'alerte, cliquez sur Mettre en veille la règle.

  2. Sélectionnez la durée de la mise en veille. Une fois la durée de la mise en veille sélectionnée, elle commence immédiatement.

Vous pouvez également mettre en veille une règle d'alerte depuis la page Alertes. Pour ce faire, recherchez l'alerte que vous souhaitez mettre en veille, cliquez sur  Plus d'options, puis sélectionnez Mettre en veille. Vous pouvez mettre en veille les règles d'alerte en cas de panne pour éviter de recevoir d'autres notifications pendant le dépannage.

Fermer les alertes

Vous pouvez laisser Monitoring fermer une alerte pour vous, ou vous pouvez la fermer une fois que les observations cessent d'arriver. Si vous fermez une alerte et que des données arrivent par la suite, indiquant que la condition est remplie, une nouvelle alerte est créée. Lorsque vous fermez une alerte, cela ne ferme pas les autres alertes ouvertes pour la même condition. Si vous mettez en veille une règle d'alerte, les alertes ouvertes sont fermées au début de la mise en veille.

La surveillance ferme automatiquement une alerte dans les cas suivants :

  • Conditions de seuil des métriques :

    • Une observation arrive et indique que le seuil n'est pas dépassé.

    • Aucune observation n'arrive, la condition est configurée pour fermer les alertes lorsque les observations cessent d'arriver, et l'état de la ressource sous-jacente est inconnu ou n'est pas désactivé.

    • Aucune observation n'arrive pendant la durée de clôture automatique de la règle d'alerte, et la condition n'est pas configurée pour fermer automatiquement les alertes lorsque les observations cessent d'arriver. Pour configurer la durée de fermeture automatique, vous pouvez utiliser la console Google Cloud ou l'API Monitoring. Par défaut, la durée de fermeture automatique est de sept jours. La durée minimale de la fermeture automatique est de 30 minutes.

  • Conditions d'absence de métrique :

    • Une observation est effectuée.
    • Aucune observation n'est reçue pendant 24 heures après l'expiration de la durée de clôture automatique de la règle d'alerte. Pour configurer la durée de fermeture automatique, vous pouvez utiliser la console Google Cloud ou l'API Monitoring. Par défaut, la durée de fermeture automatique est de sept jours.

  • Conditions de prévision :

    • Une prévision est générée et indique que la série temporelle ne dépassera pas le seuil au cours de la fenêtre de prévision.

    • Aucune observation n'arrive pendant 10 minutes, la condition est configurée pour fermer les alertes lorsque les observations cessent d'arriver et l'état de la ressource sous-jacente est inconnu ou n'est pas désactivé.

    • Aucune observation n'arrive pendant la durée de clôture automatique de la règle d'alerte, et la condition n'est pas configurée pour fermer automatiquement les alertes lorsque les observations cessent d'arriver.

Par exemple, une règle d'alerte a généré une alerte, car la latence de réponse HTTP était supérieure à deux secondes pendant 10 minutes consécutives. Si la prochaine mesure de la latence de réponse HTTP est inférieure ou égale à deux secondes, l'alerte est clôturée. De même, si aucune donnée n'est reçue pendant sept jours, l'alerte est clôturée.

Pour fermer une alerte :

  1. Dans le tableau Alertes de la page Alertes, cliquez sur Afficher toutes les alertes.

  2. Sur la page Alertes, recherchez l'alerte que vous souhaitez clôturer, puis effectuez l'une des opérations suivantes :

    • Cliquez sur  Afficher plus, puis sélectionnez Fermer l'alerte.
    • Ouvrez la page Détails de l'alerte pour cette alerte, puis cliquez sur Fermer l'alerte.

Si le message Unable to close alert with active conditions s'affiche, cela signifie que l'alerte ne peut pas être fermée, car des données ont été reçues au cours de la dernière période d'alerte.

Si le message Unable to close alert. Please try again in a few minutes. s'affiche, cela signifie que l'alerte n'a pas pu être fermée en raison d'une erreur interne.

Conservation et limites des données

Pour en savoir plus sur les limites et la période de conservation des alertes, consultez Limites pour les alertes.

Étapes suivantes