Gérer les alertes pour les règles d'alerte basées sur SQL

Une alerte est un enregistrement du moment où la condition d'une règle d'alerte est remplie. En règle générale, Cloud Monitoring ouvre une alerte et envoie une notification lorsque la condition de la règle d'alerte est remplie. Toutefois, les alertes ne sont pas créées dans les cas suivants :

Pour chaque alerte, Monitoring crée une page Informations sur l'alerte qui vous permet de gérer l'alerte et qui fournit des informations pouvant vous aider à résoudre le problème. Par exemple, la page Détails de l'alerte affiche des listes de résumés des résultats de requêtes SQL et des alertes associées.

Ce document explique comment trouver vos alertes. Elle explique également comment utiliser la page Détails de l'alerte pour gérer les alertes des règles d'alerte basées sur SQL, qui évaluent les résultats d'une requête SQL exécutée sur des données provenant de groupes d'entrées de journal.

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 l'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 , 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 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 de la page Alertes n'affiche que 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 :

    • Affichez 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 mettre en veille sa règle d'alerte Pour accéder à ces options, cliquez sur  Autres options sur la ligne de l'alerte et effectuez une sélection dans le menu. Pour en savoir plus, consultez Gérer les alertes.

Filtrer les alertes

Pour restreindre 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

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

    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 à ceci : 
{
  "name": "projects/my-project/alerts/my-alert-id",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "resource": {
    "type": "sql_alert"
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "test-policy"
  },
  "summaryText": "The row count SQL Condition for \"test-policy\" is above the threshold of 1."
}

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 à ceci : 
{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "resource": {
        "type": "sql_alert"
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "test-policy"
      },
      "summaryText": "The row count SQL Condition for \"test-policy\" is above the threshold of 1."
    }
  ]
}
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 période avec --filter='close_time>="2025-09-10T00:00:00Z"' ou par libellé avec --filter='resource.labels.key="value"'.

  • --sort-by : liste des champs selon lesquels trier la sortie, séparés par une virgule. 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 ce paramètre 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.

Cloud 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 à ceci : 
{
  "name": "projects/my-project/alerts/my-alert-id",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "resource": {
    "type": "sql_alert"
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "test-policy"
  },
  "summaryText": "The row count SQL Condition for \"test-policy\" is above the threshold of 1."
}

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 à ceci : 
{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "resource": {
        "type": "sql_alert"
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "test-policy"
      },
      "summaryText": "The row count SQL Condition for \"test-policy\" is above the threshold of 1."
    }
  ]
}
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"`\")"

Répertoriez et filtrez 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 résultats de la requête

Le volet Temps total d'emplacement consommé par jour indique le temps passé par vos emplacements BigQuery réservés à exécuter les requêtes SQL pour la règle d'alerte au cours des dernières 24 heures.

Le volet Résultats de la requête SQL affiche une liste des résumés des résultats de la requête chaque fois qu'Observability Analytics a exécuté la requête SQL à partir de la condition de la règle d'alerte. Par défaut, la liste est filtrée pour n'afficher que les requêtes correspondant à la condition de la règle d'alerte.

  • Pour afficher la requête et le tableau des résultats de la requête à un moment précis où Observability Analytics a exécuté la requête, cliquez sur une valeur de la colonne Heure d'exécution de la requête.
  • Pour afficher uniquement les résultats de requête correspondant à la condition de la règle d'alerte ou toutes les requêtes exécutées par Observability Analytics à partir de la règle d'alerte, cliquez sur Afficher uniquement les requêtes correspondant aux conditions d'alerte.

Afficher des informations supplémentaires

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 l'atténuer. 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 autres alertes créées lorsque la condition de la règle d'alerte a été remplie.

Gérer les alertes

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

  •  Ouvert : la condition de la règle d'alerte basée sur SQL a été remplie et l'alerte est toujours ouverte. Si la même condition est à nouveau remplie et qu'une alerte est déjà ouverte, aucune nouvelle alerte n'est ouverte.

  •  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 est en cours d'examen.

  •  Fermée : Vous avez fermé l'alerte manuellement ou elle a été fermée automatiquement une fois la période de fermeture automatique expirée.

Confirmer les alertes

Lorsque vous commencez à enquêter sur la cause d'une alerte, nous vous recommandons de la marquer comme confirmée.

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.

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, les alertes associées restent ouvertes, mais ne génèrent plus de notifications. Les alertes se ferment en fonction de la durée de fermeture automatique de la règle d'alerte.

Pour créer une option de mise en veille 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 la fermer vous-même.

Monitoring ferme automatiquement une alerte lorsque la durée de fermeture automatique de la règle d'alerte expire. 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.

La durée de fermeture automatique indique le temps qui doit s'écouler, sans répétition de la cause de l'alerte, avant que l'alerte ne se ferme. C'est pourquoi, lorsqu'une alerte est ouverte et que sa cause se reproduit, elle peut rester ouverte plus longtemps que la durée de fermeture automatique.

Pour fermer une alerte :

  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 s'affiche, réessayez dans quelques minutes. Vous ne pouvez pas fermer immédiatement une nouvelle alerte, car les conditions qui l'ont déclenchée sont toujours considérées comme actives par le système d'alerte.

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