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.

Cette page explique comment utiliser Google Cloud Console pour créer et gérer une règle d'alerte. 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.

Créer une règle d'alerte

Pour créer une règle d'alerte, procédez comme suit :

  1. Dans Cloud Console, sélectionnez Surveillance :

    Accéder à Monitoring

    Si c'est la première fois que vous accédez à Monitoring depuis votre projet Google Cloud, le projet doit être associé à un espace de travail. L'association est réalisée automatiquement si vous n'avez jamais utilisé Monitoring ou si vous n'avez jamais créé d'espace de travail multiprojet. Toutefois, si vous avez déjà créé un espace de travail multiprojet, une boîte de dialogue s'affiche. Elle vous permet soit de créer un espace de travail, soit d'ajouter votre projet à un espace de travail existant. Après avoir effectué votre sélection, cliquez sur Ajouter.

  2. Sélectionnez Alertes.

  3. Cliquez sur Create Policy (Créer une règle) pour afficher la page Créer une règle d'alerte :

    La boîte de dialogue

    1. Cliquez sur Add condition (Ajouter une condition), puis remplissez la boîte de dialogue. Pour plus d'informations sur les champs d'une condition, consultez la page Spécifier des conditions.

      Une condition décrit à la fois la ressource surveillée, la métrique appliquée à cette ressource et le moment où la condition est remplie. Une règle d'alerte doit comporter au moins une condition, et pas plus de six conditions. Si une règle d'alerte ne comporte qu'une condition et que celle-ci est remplie, alors un incident est créé. Si une règle d'alerte comporte plusieurs conditions, vous devez spécifier comment ces conditions se combinent entre elles. Pour plus d'informations, consultez la section Règles comportant plusieurs conditions.

    2. Cliquez sur Next (Suivant) pour accéder à la section des notifications.

    3. Pour être informé lorsqu'un incident est créé, ajoutez un canal de notification à votre règle d'alerte. 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, cliquez sur Notification channels (Canaux de notification). Dans la boîte de dialogue, sélectionnez un ou plusieurs canaux de notification dans le menu, puis cliquez sur OK.

      Boîte de dialogue de notification affichant les boutons d'actualisation et de gestion des canaux.

      Si un canal de notification que vous souhaitez ajouter n'est pas répertorié, cliquez sur Gérer les canaux de notification. La page Canaux de notification s'affiche dans un nouvel onglet du navigateur. Sur cette page, vous pouvez mettre à jour les canaux de notification configurés. Une fois vos mises à jour effectuées, revenez à l'onglet d'origine, cliquez sur Actualiser , puis sélectionnez les canaux de notification à ajouter à la règle d'alerte. Pour en savoir plus, consultez la section Créer un canal à la demande.

    4. Cliquez sur Next (Suivant) pour passer à la section de documentation.

    5. Cliquez sur Nom, puis saisissez un nom de règle. Ce nom est inclus dans les notifications et affiché sur la page Règles.

    6. (Facultatif) Spécifiez la documentation à inclure dans les notifications. 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.

  4. Cliquez sur Enregistrer.

Gérer des règles

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

  1. Dans Cloud Console, sélectionnez Surveillance :

    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.

Sur la page Policies (Règles), vous pouvez modifier, supprimer, copier, activer ou désactiver les règles 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 boîte de dialogue de confirmation, sélectionnez Delete (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 page 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é).