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 l'échec et à gérer le cycle de vie de l'alerte.

Sur la page Détails de l'alerte, vous pouvez consulter la chronologie de l'alerte, 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 le respect d'une seule condition déclenche une alerte. Monitoring ne crée pas d'alerte si la règle est mise en attente 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 ou le projet de gestion App Hub.

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 de votre projet, utilisez la console Google Cloud , la gcloud CLI ou l'API Monitoring.

Console Google Cloud

Pour lister les alertes de votre projet Google Cloud , procédez comme suit :

  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 ou le projet de gestion App Hub.

    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 des alertes plus anciennes

Le tableau Alertes de 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écent ou  Plus ancien.

  • 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 en savoir plus sur l'ajout de filtres, consultez Filtrer les alertes.
    • Confirmer ou fermer une alerte, ou répéter sa règle d'alerte. Pour accéder à ces options, cliquez sur  Plus d'options sur la ligne de l'alerte, puis effectuez une sélection 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 éléments suivants :

    • État de l'alerte
    • Nom de la règle d'alerte
    • Date et heure 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 une valeur 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 s'affiche alors 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 détails sur l'alerte, tels que l'état de l'alerte, les étiquettes associées et la règle d'alerte source. La réponse ressemble à ceci :
{
  "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 la 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 détails sur l'alerte, tels que l'état de l'alerte, les étiquettes associées et la règle d'alerte source. La réponse ressemble à ceci :
{
  "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 étiquette. 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 le résultat. 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 plus 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 détails 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 détails sur l'alerte, tels que l'état de l'alerte, les étiquettes associées et la règle d'alerte source. La réponse ressemble à ceci :
{
  "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 détails sur l'alerte, tels que l'état de l'alerte, les étiquettes associées et la règle d'alerte source. La réponse ressemble à ceci :
{
  "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'option --data-urlencode suivie 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"`\")"

Répertoriez et filtrez 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"`\")"

Répertorier et filtrer les alertes par étiquette utilisateur. Dans cet exemple, filtrez par étiquette 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 se servir de l'exemple suivant pour ajouter un filtre basé sur le temps à 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 l'alerte, utilisez le graphique Métriques d'alerte. Ce graphique affiche une chronologie et la série temporelle qui a entraîné le respect de 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 basculer entre l'affichage des séries temporelles qui ont entraîné le respect de la condition et l'affichage de 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 à l'aide de votre pointeur.

Vous pouvez également analyser vos données de métriques plus en détail 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 sur 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 pertinentes pour votre alerte. À l'exception des règles d'alerte qui surveillent les métriques basées sur les journaux, ce volet affiche les entrées de journal qui correspondent au type de ressource et aux étiquettes de la série temporelle qui a déclenché l'alerte. Toutefois, si une règle d'alerte surveille une métrique basée sur les journaux définie dans le même projet, ce volet affiche les entrées de journal qui correspondent à la requête de filtre de la métrique. Cette requête n'inclut pas de filtres de condition ni d'étiquettes d'agrégation, telles que des étiquettes de regroupement (groupByFields).

Vous pouvez analyser ces entrées de journal pour trouver des informations supplémentaires susceptibles de 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 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 les 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 vers un tableau de bord.

Afficher des informations supplémentaires

La section Libellés affiche les libellés et les valeurs de la ressource surveillée et de la métrique 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 des alertes avec des libellés.

La section Documentation affiche le modèle de documentation pour les notifications que vous avez fourni 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 d'atténuation. 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 à détecter 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 éléments 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 l'alerte affichée sur la page Détails de l'alerte.

Gérer les alertes

Les alertes peuvent se trouver dans 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é marquée manuellement comme confirmée. En règle générale, cet état indique que l'alerte est en cours d'examen.

  •  Fermée : Le système a observé que la condition n'était plus remplie, vous avez fermé l'alerte, ou sept jours se sont écoulés sans qu'il ait été observé que la condition continuait d'être remplie.

Lorsque vous configurez une règle d'alerte, assurez-vous que l'état stable fournit un signal lorsque tout est OK. 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 qu'une alerte est 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 produit un nombre d'erreurs de 0 lorsqu'il n'y a pas d'erreur. Si la règle d'alerte renvoie une valeur nulle ou vide dans l'état sans erreur, aucun signal n'indique l'arrêt des erreurs. 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 confirmée lorsque vous commencez à en rechercher la cause.

Pour marquer une alerte comme confirmée, procédez comme suit :

  1. Dans le tableau Alertes de la page Alertes, cliquez sur Voir toutes les alertes.
  2. Sur la page Alertes, recherchez l'alerte que vous souhaitez confirmer, 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 Confirmer 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. Les notifications répétées continuent d'être envoyées à chaque intervalle configuré tant que l'alerte reste ouverte. 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 pause 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 à cette règle.

Pour créer une mise en attente pour une alerte que vous consultez, procédez comme suit :

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

  2. Sélectionnez la durée de la mise en veille. Une fois que vous avez sélectionné la durée de la mise en pause, celle-ci commence immédiatement.

Vous pouvez également mettre en pause une règle d'alerte depuis la page Alertes en recherchant l'alerte que vous souhaitez mettre en pause, en cliquant sur  Autres options, puis en sélectionnant Mettre en pause. Vous pouvez mettre en veille les règles d'alerte pendant les pannes pour éviter de recevoir d'autres notifications pendant le processus de dépannage.

Fermer les alertes

Vous pouvez laisser Monitoring fermer une alerte pour vous, ou vous pouvez fermer une alerte une fois que les observations cessent d'arriver. Si vous fermez une alerte et que des données arrivent ensuite, indiquant que la condition est remplie, une nouvelle alerte est créée. Lorsque vous fermez une alerte, cette action ne ferme aucune autre alerte ouverte 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.

Monitoring ferme automatiquement une alerte lorsque l'un des événements suivants se produit :

  • Conditions de seuil des métriques :

    • Une observation arrive, indiquant 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 fermeture 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'arrive pendant 24 heures après l'expiration de la durée de fermeture 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 fermeture 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 mesure suivante de la latence de réponse HTTP est inférieure ou égale à deux secondes, l'alerte est fermée. De même, si aucune donnée n'est reçue pendant sept jours, l'alerte est fermée.

Pour fermer une alerte, procédez comme suit :

  1. Dans le tableau Alertes de la page Alertes, cliquez sur Voir toutes les alertes.
  2. Sur la page Alertes, recherchez l'alerte que vous souhaitez fermer, 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, l'alerte ne peut pas être fermée, car des données ont été reçues au cours de la période d'alerte la plus récente.

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