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

Les alertes Cloud Monitoring vous permettent de suivre et d'examiner les problèmes lorsque les résultats d'une requête SQL sur des entrées de journal groupées remplissent la condition d'une règle d'alerte basée sur SQL. Pour chaque alerte, Monitoring envoie une notification et crée une page Détails de l'alerte pour vous aider à résoudre les problèmes liés à l'échec et à gérer le cycle de vie de l'alerte.

Sur la page Détails de l'alerte, vous pouvez consulter les résumés des résultats de la requête SQL et les liens vers les alertes associées. 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 pour les alertes.

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

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

    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-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 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-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 é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-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 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-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'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 résultats de la requête

Le volet Informations sur la requête indique si les requêtes de la règle d'alerte s'exécutent sur des emplacements BigQuery à la demande ou sur une réservation. Ce volet affiche également une estimation du nombre d'octets analysés et du temps d'emplacement consommé par jour, en fonction des requêtes exécutées au cours des sept derniers jours.

Le volet Résultats de la requête SQL affiche une liste de résumés des résultats de la requête pour chaque exécution de la requête SQL par Analyse de l'observabilité à 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 la table des résultats de la requête à un moment précis où l'Analyse de l'observabilité a exécuté la requête, cliquez sur une valeur de la colonne Heure d'exécution de la requête.
  • Pour basculer entre l'affichage des résultats de requête correspondant à la condition de la règle d'alerte et l'affichage de toutes les requêtes exécutées par l'Analyse de l'observabilité à 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 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 autres alertes créées lorsque la condition de la règle d'alerte a été remplie.

Gérer les alertes

Les alertes peuvent se trouver dans 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é 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 : vous avez fermé l'alerte manuellement ou elle a été fermée automatiquement après l'expiration de la période de fermeture automatique.

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.

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 pause une règle d'alerte, les alertes associées à cette règle restent ouvertes, mais ne déclenchent 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 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 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 spécifie 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, l'alerte peut rester ouverte plus longtemps que la durée de fermeture automatique.

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 s'affiche, réessayez dans quelques minutes. Vous ne pouvez pas fermer une nouvelle alerte immédiatement, 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