Gérer les règles d'alerte

Une règle d'alerte décrit un ensemble de conditions que vous souhaitez surveiller. Ces conditions peuvent être liées à l'état d'un système non opérationnel ou à la consommation de ressources. Par exemple, vous souhaiterez peut-être créer une règle permettant de surveiller un test de disponibilité ou l'utilisation de l'API Cloud Monitoring. Outre les conditions, dans une règle d'alerte, vous pouvez spécifier le mode de notification et la documentation à inclure dans cette notification.

Vous trouverez sur cette page la procédure à suivre pour créer et gérer des règles d'alerte à l'aide de Monitoring dans Google Cloud Console. Vous pouvez également utiliser l'API Cloud Monitoring pour effectuer ces tâches. Pour plus d'informations sur cette approche, consultez la page Gérer des règles d'alerte à l'aide d'API. Pour afficher les règles représentées au format JSON, consultez la page Exemples de règles.

Avant de commencer

Avant de créer des règles d'alerte, vous devez vous familiariser avec la terminologie et les concepts généraux utilisés avec les règles d'alerte. Cela inclut la compréhension des composants d'une règle, du concept d'incident, de la tarification et des limites. Pour plus d'informations, consultez la section Présentation des alertes.

Canaux de notification

Les canaux de notification vous permettent de spécifier la manière dont vous souhaitez être informé des alertes. Si un type de canal de notification est configuré, vous avez la possibilité de le sélectionner lors de la configuration des notifications relatives à votre règle d'alerte.

Pour obtenir une liste des types de canaux de notification et des informations sur la configuration des canaux, consultez la page Options de notification.

Règles d'alerte portant sur des tests de disponibilité

Créez une règle d'alerte pour un test de disponibilité dans la fenêtre Tests de disponibilité. Si vous suivez cette consigne, la plupart des champs de la règle d'alerte sont préconfigurés :

Créer une règle d'alerte

  1. Dans Cloud Console, sélectionnez Monitoring :

    Accéder à Monitoring

    Si vous n'avez jamais utilisé Monitoring, un espace de travail est automatiquement créé, et votre projet est associé à cet espace de travail. Sinon, si votre projet n'est pas associé à un espace de travail, une boîte de dialogue s'affiche. Vous pouvez soit créer un espace de travail, soit ajouter ce projet à un espace de travail existant. Après avoir effectué votre sélection, cliquez sur Ajouter. Une fois l'espace de travail créé, vous êtes automatiquement redirigé vers Alertes.

  2. Sélectionnez Alertes.

  3. Cliquez sur Créer une stratégie.

    La boîte de dialogue

  4. Une fois que vous avez spécifié le nom, les conditions et les canaux de notification, et que vous avez ajouté de la documentation, cliquez sur Save (Enregistrer).

Dénomination

Dans la fenêtre Create New Alerting Policy (Créer une règle d'alerte), entrez un nom de règle : Le nom de la règle est inclus dans les notifications et affiché dans la fenêtre Règles.

Conditions

Chaque condition d'une règle d'alerte décrit une ressource qui est surveillée et à quel moment cette ressource ne respecte pas le comportement attendu. Si une règle d'alerte comporte une condition, vous souhaitez qu'une alerte soit générée si cette condition n'est pas respectée. Pour plus d'informations sur les conditions multiples, consultez la section Conditions multiples.

Pour ajouter une condition d'alerte à une règle, cliquez sur le bouton Create New Alerting Policy (Créer une règle d'alerte) dans la fenêtre Add Condition (Ajouter une condition). Pour en savoir plus sur la définition des conditions, consultez la page Spécifier des conditions.

Conditions multiples

Une règle d'alerte peut contenir jusqu'à six conditions.

Si vous utilisez l'API Cloud Monitoring ou si vos règles d'alerte comportent plusieurs conditions, vous devez spécifier quand le non-respect des conditions individuelles entraîne la génération d'une alerte :

  • Si vous utilisez Google Cloud Console, utilisez le champ Policy Triggers (Déclenchements de règle).
  • Si vous utilisez l'API Cloud Monitoring, utilisez le champ combiner.

Ce tableau répertorie les paramètres dans Cloud Console, la valeur équivalente dans l'API Cloud Monitoring et une description de chaque paramètre :

Valeur des déclencheurs de règles
dans Cloud Console
Valeur combinée
dans l'API Cloud Monitoring
Signification
Any condition is met
(N'importe quelle condition est remplie, valeur par défaut)
OR Une alerte est générée si une ressource ne respecte pas l'une des conditions.
All conditions are met (Toutes les conditions sont remplies) AND Une alerte est générée si chaque condition est enfreinte par au moins une ressource, même si une ressource différente enfreint chaque condition.
All conditions are met
on matching resources
(Toutes les conditions sont remplies sur les ressources correspondantes)
AND_WITH_MATCHING_RESOURCE Une alerte est générée si chaque condition est enfreinte par la même ressource. Ce paramètre est le plus contraignant.

Notifications

Les canaux de notification vous permettent de spécifier la manière dont vous souhaitez être informé des alertes. Si vous n'ajoutez pas au moins un canal de notification, vous ne recevez pas de notification en cas d'incident. Vous pouvez ajouter plusieurs canaux de notification. Pour plus de détails sur vos choix de canaux de notification, consultez la page Options de notification.

Pour ajouter un canal de notification, procédez comme suit :

  1. Cliquez sur Add Notification Channel (Ajouter un canal de notification).
  2. Sélectionnez le type de canal de notification.
  3. Vous devrez peut-être renseigner des champs supplémentaires. Par exemple, si vous sélectionnez E-mail, vous êtes invité à saisir votre adresse e-mail.
  4. Cliquez sur Ajouter.

Pour ajouter un canal de notification à votre règle, répétez les étapes précédentes. La configuration d'au moins deux types de canaux de notification augmente la fiabilité.

Documentation

La documentation est incluse dans les notifications pour vous aider à gérer la condition d'échec. Vous pouvez utiliser le format Markdown pour mettre en forme la documentation ou utiliser du texte brut.

Outre le format Markdown, vous pouvez utiliser des variables pour extraire des informations de la règle elle-même afin de personnaliser le contenu de la documentation. Pour plus d'informations, consultez la section Utiliser des variables.

Par exemple, la documentation peut inclure un titre tel que Addressing High CPU Usage (Résoudre l'utilisation élevée du processeur) et des informations permettant d'identifier le projet :

## Addressing High CPU Usage

    This note contains information about high CPU Usage.

    You can include variables in the documentation. For example:

    This alert originated from the project ${project}, using
    the variable $${project}.
    

Les variables ne sont remplacées par leurs valeurs que dans les notifications. Le volet Prévisualiser au format Markdown, et les autres emplacements dans Cloud Console qui affichent la documentation, ne reflètent que le format Markdown :

Exemple de rédaction d'une note de documentation avec Markdown.

Vous pouvez également ajouter des tags spécifiques au canal pour contrôler les notifications. Pour plus d'informations, consultez la section Utiliser des contrôles de canal.

Gérer des règles

Pour répertorier toutes les règles d'alerte, procédez comme suit :

  1. Dans Cloud Console, sélectionnez Monitoring :

    Accéder à Monitoring

  2. Sélectionnez Alertes.

  3. Une liste partielle des règles s'affiche dans le volet Policies (Règles). Pour afficher toutes les règles et activer le filtrage, cliquez sur See all policies (Voir toutes les règles).

Pour afficher les détails d'une règle d'alerte, cliquez sur son nom.

Pour restreindre les règles d'alerte répertoriées, ajoutez des filtres. Chaque filtre est composé d'un nom et d'une valeur. Vous pouvez définir la valeur comme étant une correspondance exacte ou une correspondance partielle d'un nom de règle. Les correspondances ne sont pas sensibles à la casse. Si vous avez plusieurs filtres, ils sont automatiquement reliés par un opérateur logique AND, sauf si vous insérez un filtre OR. La capture d'écran suivante répertorie toutes les règles d'alerte correspondant à test ou My Uptime Check Alert Policy :

Exemple de présentation des alertes avec des filtres.

Dans la fenêtre Policies (Règles), vous pouvez modifier, supprimer, copier, activer ou désactiver une règle d'alerte :

  • Pour modifier ou copier une règle, cliquez sur Plus d'options , puis sélectionnez l'option correspondante. La modification et la copie d'une règle sont des opérations semblables à la création d'une règle d'alerte. Vous pouvez modifier et, dans certains cas, supprimer les valeurs dans les champs. Lorsque vous avez terminé, cliquez sur Enregistrer.

  • Pour supprimer une règle, cliquez sur Plus d'options , puis sélectionnez Supprimer. Dans la fenêtre de confirmation, sélectionnez Supprimer.

  • Pour modifier l'état d'activation des règles d'alerte, cliquez sur le bouton situé sous l'en-tête Enabled (Activé).

Si vous sélectionnez une règle d'alerte, la fenêtre Policy details (Détails des règles) s'affiche. Par exemple, la capture d'écran suivante présente les détails de la règle d'alerte nommée My Uptime Check Alert Policy :

Exemple de page de détails d'une règle d'alerte

Vous pouvez modifier, supprimer, copier, activer ou désactiver une règle d'alerte à partir de la fenêtre Policy details (Détails des règles). Par exemple, pour désactiver une règle d'alerte actuellement activée, cliquez sur Enabled (Activé), puis sélectionnez Turn off (Désactiver). De même, pour activer une règle actuellement désactivée, cliquez sur Disabled (Désactivé).