Afficher les événements sur un tableau de bord

Console

Pour afficher les événements de la session en cours, procédez comme suit:

1. Dans la console Google Cloud, accédez à la page Tableaux de bord .

   Accédez à Tableaux de bord.

   Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Surveillance.

2. Sélectionnez le tableau de bord que vous souhaitez afficher.

3. Dans la barre d'outils du tableau de bord, assurez-vous que l'option Événements est activée.

   Si l'option Events (Événements) n'est pas affichée, cela signifie que le tableau de bord n'accepte pas l'affichage des événements.

4. Pour chaque type d'événement que vous souhaitez afficher, cliquez sur Ajouter un événement dans la barre d'outils du tableau de bord, puis sélectionnez le type d'événement dans le menu.

   Par exemple, vous pouvez configurer votre tableau de bord pour afficher les événements "Déploiement de la charge de travail GKE".

   Une fois que vous avez ajouté un type d'événement, Cloud Monitoring interroge les données de journaux, ce qui prend quelques instants, puis ajoute les annotations aux graphiques du tableau de bord:

   • info Info: message d'information.
   • warning Avertissement: indique une défaillance, telle qu'un redémarrage ou un plantage.
   • notifications Alerte: indique qu'un incident a été ouvert.

5. Pour afficher le résumé d'un événement ou pour accéder aux liens vers les entrées de journal, activez l'info-bulle à l'aide de votre pointeur.

6. Facultatif: Votre configuration ne s'applique qu'à la session en cours. Pour enregistrer votre configuration, procédez comme suit:

   1. Dans la barre d'outils du tableau de bord, cliquez sur settings Paramètres, sélectionnez JSON, puis Éditeur JSON.

   2. Dans l'éditeur JSON, ajoutez un objet annotations. Cet objet contient un tableau d'objets EventAnnotation qui spécifient les types d'événements à afficher.

      Voici un exemple d'objet annotations pour un événement de mise à jour d'un cluster. Dans cet exemple, le champ filter limite les événements à un cluster spécifique:

      "annotations": {
        "defaultResourceNames": [],
        "eventAnnotations": [
          {
            "displayName": "",
            "enabled": true,
            "eventType": "GKE_CLUSTER_UPDATE",
            "filter": "resource.labels.cluster_name=my-cluster",
            "resourceNames": []
          }
        ]
      }
      

      Pour en savoir plus sur l'objet annotations, sélectionnez l'onglet API de cette table.

   3. Cliquez sur Appliquer les modifications, puis sur Enregistrer.

API

Pour configurer un tableau de bord personnalisé afin d'afficher les événements, incluez un champ annotations dans l'objet Dashboard. Le champ annotations contient une instance d'un objet DashboardAnnotations qui comporte deux champs:

• Le champ defaultResourceName répertorie les valeurs par défaut au niveau du tableau de bord pour les projets Google Cloud permettant de rechercher des événements. Si vous ne spécifiez pas ce champ, la recherche est effectuée dans le projet sélectionné.

• Tableau d'objets EventAnnotation. Chaque objet contient les éléments suivants:

  • Un champ displayName, qui vous permet de définir le libellé sur le bouton d'activation/de désactivation spécifique à l'événement. Si ce champ n'est pas spécifié ou que sa valeur est une chaîne vide, le nom par défaut de l'événement s'affiche.
  • Un champ enabled, qui contrôle la valeur du bouton d'activation/de désactivation de l'événement. Lorsque la valeur est true, le bouton d'activation est défini sur on et les événements sont affichés sur le tableau de bord. Lorsque false, le bouton d'activation se trouve sur off.
  • Un champ eventType, qui contient une valeur provenant de l'énumération EventType.
  • Un champ filter, qui vous permet de spécifier une requête à ajouter à la requête spécifique à un événement. Lorsque la valeur de ce champ est une chaîne vide, la requête spécifique à l'événement est utilisée.
  • Un champ resourceNames, qui vous permet de définir une liste de projets Google Cloud dans lesquels rechercher des événements. Lorsque ce champ correspond à un tableau vide, la recherche est effectuée dans le projet sélectionné.

Voici un exemple d'objet annotations pour un événement de mise à jour d'un cluster. Dans cet exemple, le champ filter limite les événements à un cluster spécifique:

"annotations": {
  "defaultResourceNames": [],
  "eventAnnotations": [
    {
      "displayName": "",
      "enabled": true,
      "eventType": "GKE_CLUSTER_UPDATE",
      "filter": "resource.labels.cluster_name=my-cluster",
      "resourceNames": []
    }
  ]
}

Pour plus d'informations sur l'utilisation de l'API Cloud Monitoring pour créer des tableaux de bord, consultez les pages Créer et gérer des tableaux de bord à l'aide d'API et Exemple: Activer les événements dans les tableaux de bord.

Console

Pour créer une alerte basée sur les journaux, procédez comme suit:

1. Si vous n'avez pas configuré de canal de notification, procédez comme suit:

   1. Dans la console Google Cloud, accédez à la page notifications Alertes:

      Accéder à l'interface des alertes

      Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Surveillance.

   2. Cliquez sur Modifier le canal de notification.
   3. Accédez au type de canal de notification que vous souhaitez configurer, cliquez sur Ajouter, puis remplissez les champs de la boîte de dialogue.

2. Dans la console Google Cloud, accédez à la page Explorateur de journaux :

   Accéder à l'explorateur de journaux

   Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Logging.

3. Dans la barre d'outils, sélectionnez Créer une alerte.

4. Saisissez un nom pour la règle d'alerte, puis cliquez sur Suivant.

5. Dans la section Définir les entrées de journal sur lesquelles générer une alerte, saisissez une requête ou mettez à jour la requête copiée à partir du volet Requête lorsque vous avez sélectionné Créer une alerte.

   Pour chaque type d'événement, la page Types d'événements répertorie une requête pouvant être utilisée dans une règle d'alerte basée sur les journaux.

6. Renseignez la boîte de dialogue, puis cliquez sur Enregistrer.

API

Pour créer une règle d'alerte basée sur les journaux à l'aide de l'API Cloud Monitoring, procédez comme suit:

1. Identifiez la requête à inclure dans la condition de la règle d'alerte. Pour chaque type d'événement, la page Types d'événements répertorie une requête pouvant être utilisée dans une règle d'alerte basée sur les journaux.

2. Créez le fichier JSON contenant la représentation de la règle d'alerte. Pour en savoir plus sur cette étape et obtenir un exemple, consultez Concevoir la règle d'alerte.

3. Appelez la méthode API alertPolicies.create. Par exemple, vous pouvez exécuter la commande gcloud alpha monitoring policies create.

Console

Pour masquer tous les événements, assurez-vous que l'option toggle_off Events (Événements) est désactivée dans la barre d'outils du tableau de bord.

Pour masquer un type d'événement, désactivez le bouton correspondant.

API

Pour masquer un type d'événement dans un tableau de bord personnalisé, recherchez l'objet EventAnnotation correspondant au type d'événement, puis définissez le champ enabled sur false.

Pour plus d'informations sur l'utilisation de l'API Cloud Monitoring, consultez la page Créer et gérer des tableaux de bord à l'aide d'API.