Afficher les événements sur un tableau de bord

Ce document explique comment afficher des événements dans les graphiques d'un tableau de bord. Un événement est une activité, telle qu'un déploiement ou un plantage, qui affecte le fonctionnement d'un système. L'affichage d'événements peut vous aider à mettre en corrélation des données provenant de différentes sources lorsque vous tentez de résoudre un problème.

Les événements sont identifiés en interrogeant les journaux générés dans votre projet Google Cloud ou directement acheminés vers votre projet Google Cloud, pour des types d'événements spécifiques. Les journaux d'autres projets Google Cloud, même s'ils sont stockés dans un bucket de journaux du projet Google Cloud en cours, ne sont pas interrogés. Vous pouvez utiliser les requêtes fournies dans l'explorateur de journaux et dans les règles d'alerte basées sur les journaux. Pour obtenir la liste des événements et des requêtes correspondantes, consultez la page Types d'événements.

Si vous configurez un tableau de bord pour afficher des événements, les graphiques de vos tableaux de bord sont annotés au fur et à mesure que ces événements se produisent. Les filtres de tableau de bord, qui limitent les données affichées par un tableau de bord, filtrent généralement à la fois les données de séries temporelles et les événements.

La capture d'écran suivante illustre un graphique affichant une annotation, avec l'info-bulle de l'annotation activée:

Chaque annotation peut répertorier plusieurs événements. Dans la capture d'écran précédente, un événement de déploiement GKE est listé.

Avant de commencer

Pour obtenir les autorisations nécessaires pour afficher les graphiques et les journaux et créer des règles d'alerte, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet:

• Afficher les graphiques, et afficher et créer des règles d'alerte : Éditeur Monitoring (roles/monitoring.editor).
• Affichez tous les journaux, à l'exception des journaux d'accès aux données, qui sont créés dans votre projet Google Cloud : Lecteur de journaux (roles/logging.viewer).
• Affichez les journaux d'accès aux données créés dans votre projet Google Cloud : Lecteur des journaux privés (roles/logging.privateLogViewer).

Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Afficher les événements

Pour obtenir la liste des types d'événements, des références de dépannage et des requêtes pouvant être utilisés avec l'explorateur de journaux ou avec les règles d'alerte basées sur les journaux, consultez la page Types d'événements.

Remarque :Pour des raisons de performances, les tableaux de bord limitent le nombre d'événements qu'ils affichent. Une fois ces limites atteintes, les tableaux de bord n'affichent que les événements les plus récents. Pour afficher des événements plus anciens, définissez une période plus courte ou ajoutez des filtres.

Console

Pour afficher les événements, procédez comme suit:

1. Dans le panneau de navigation de la console Google Cloud, sélectionnez Monitoring, puis  Tableaux de bord :

   Accédez à Tableaux de bord.

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: message d'information.
   • Avertissement: indique une défaillance, telle qu'un redémarrage ou un plantage.
   • Alerte: indique qu'un incident a été ouvert.

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

Afficher les journaux d'un événement

Lorsque vous consultez un graphique qui affiche des annotations d'événements, vous pouvez accéder aux journaux associés aux événements:

• Pour afficher les journaux d'un événement spécifique, utilisez votre pointeur pour activer l'info-bulle d'une annotation répertoriant l'événement, accédez à l'événement, puis cliquez sur Afficher les journaux.

• Pour afficher les journaux de tous les événements identifiés par l'annotation, utilisez votre pointeur pour activer l'info-bulle correspondante, accédez à la ligne récapitulative de l'info-bulle, puis cliquez sur Afficher les journaux.

Dans un autre onglet du navigateur, l'explorateur de journaux s'ouvre avec les paramètres de requête définis pour interroger l'événement spécifique ou la collection d'événements.

Créer des règles d'alerte

Pour recevoir une notification lorsqu'un événement apparaît dans vos journaux, configurez une alerte basée sur les journaux. Les règles d'alerte basées sur les journaux interrogent vos journaux dès leur réception. Lorsque la requête renvoie un résultat non vide, un incident est créé et des notifications sont envoyées.

Console

Remarque :Pour créer une alerte pour un événement que vous consultez, activez l'info-bulle correspondante, cliquez sur Afficher les journaux, puis passez à l'étape de création d'alerte dans la procédure suivante.

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 le panneau de navigation de la console Google Cloud, sélectionnez Monitoring, puis  Alertes :

      Accéder à l'interface des alertes

   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 le panneau de navigation de la console Google Cloud, sélectionnez Logging, puis Explorateur de journaux :

   Accéder à l'explorateur de journaux

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 alerte basée sur les journaux.

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

Masquer les événements

Console

Pour masquer tous les événements, assurez-vous que l'option 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.

Étapes suivantes

• Partager un tableau de bord personnalisé
• Explorer les données représentées graphiquement
• Accéder aux tableaux de bord spécifiques aux ressources
• Ajouter des filtres temporaires aux tableaux de bord personnalisés
• Ajouter des filtres permanents aux tableaux de bord personnalisés