Afficher des traces dans un tableau de bord personnalisé

Ce document explique comment afficher les données de trace sur des tableaux de bord personnalisés. En ajoutant des widgets de trace à vos tableaux de bord, vous pouvez créer une vue de dépannage unifiée qui met en corrélation les latences des segments avec les métriques système et les journaux d'application.

Pour afficher les données de trace dans un tableau de bord, vous pouvez ajouter un widget spécifique aux traces, utiliser une option d'enregistrement sur la page Explorateur de traces ou utiliser l'API Cloud Monitoring.

Visualiser les données de trace

La page Explorateur de traces fournit une suite préconfigurée de visualisations pour le dépannage. Par défaut, elle affiche une carte de densité des latences de segment et des listes de segments individuels ou groupés. Pour en savoir plus, consultez Rechercher et explorer des traces.

Comme les tableaux de bord personnalisés sont modulaires, vous pouvez créer une version persistante de cette vue complète en combinant des widgets de trace individuels. Par exemple, vous pouvez ajouter un widget de carte de densité à côté de tableaux distincts pour les portées groupées et individuelles. En recréant cette mise en page dans un tableau de bord, vous pouvez surveiller tous les aspects de vos données de trace dans une vue unique et partagée avec vos autres données de télémétrie :

Tableau de bord affichant les données de trace.

Par défaut, les widgets de trace affichent les données des ressources de votre portée de trace par défaut. Toutefois, vous pouvez modifier le champ d'application des widgets individuels pour rechercher différents projets ou vous concentrer sur des groupes de ressources spécifiques.

Lorsque vous modifiez un widget de trace, une version intégrée de l'explorateur de traces s'ouvre. Cet éditeur vous permet d'ajouter des filtres et de modifier les options de configuration, comme vous le feriez lors d'une investigation, avant d'appliquer les modifications permanentes aux vignettes de votre tableau de bord.

Avant de commencer

Pour obtenir les autorisations nécessaires pour afficher les données de trace dans un tableau de bord personnalisé, demandez à votre administrateur de vous accorder les rôles IAM suivants :

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.

Un tableau de bord peut contenir jusqu'à 100 widgets simultanément.

Utiliser l'option d'enregistrement sur la page Explorateur Trace

L'explorateur de traces propose plusieurs visualisations de vos données de trace. Vous pouvez ajouter ces visualisations à un tableau de bord pour créer une vue similaire.

Pour enregistrer des données de l'explorateur de traces dans un tableau de bord personnalisé, procédez comme suit :

  1. Dans la console Google Cloud , accédez à la page  Explorateur Trace :

    Accéder à Explorateur Trace

    Vous pouvez également accéder à cette page à l'aide de la barre de recherche.

  2. Dans la barre d'outils, sélectionnez Enregistrer dans le tableau de bord.

  3. Sélectionnez le style d'affichage. Vous avez plusieurs options :

    • Visualiseur : ajoutez une carte de densité à votre tableau de bord.
    • Tableau de spans : ajoutez un tableau de spans individuels à votre tableau de bord.
    • Tableau de spans groupés : ajoutez un tableau de spans groupés à votre tableau de bord.

  4. Sélectionnez ou créez un tableau de bord.

  5. Cliquez sur Enregistrer dans le tableau de bord.

Ajouter un widget de trace à un tableau de bord personnalisé

Cette section explique comment afficher les données de trace sur un tableau de bord personnalisé. Ces instructions concernent la console Google Cloud et supposent que vous modifiez un tableau de bord. Pour en savoir plus sur l'utilisation de l'API Cloud Monitoring, consultez la section Tableau de bord affichant des données de trace.

Pour afficher les données de trace sur un tableau de bord personnalisé, procédez comme suit :

  1. Ouvrez un tableau de bord personnalisé :

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

      Accéder à la page Tableaux de bord

      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 App Hub ou le projet de gestion.

    3. Sélectionnez un tableau de bord ou cliquez sur Créer un tableau de bord.

      Si vous créez un tableau de bord, utilisez le menu Champ d'application pour configurer les ressources dans lesquelles rechercher les données de trace. Par défaut, le système recherche les ressources dans le champ d'application de trace par défaut pour les données de trace.

  2. Dans la barre d'outils, cliquez sur  Ajouter un widget.

  3. Dans la boîte de dialogue Ajouter un widget, accédez à la section Données, puis sélectionnez Trace.

  4. Configurez le widget Trace. Vous pouvez modifier la vue par défaut, le titre et ajouter des filtres.

    • Pour modifier la vue, dans la barre d'outils, développez le menu Vue du graphique et sélectionnez une vue :

      • Pour ajouter une carte de densité (par défaut), sélectionnez Durée du segment (carte de densité).
      • Pour afficher le taux de couverture, sélectionnez Débit du segment (graphique en courbes).
      • Pour afficher les données de latence, sélectionnez Durée de la portée (centile).
      • Pour lister les spans au format tabulaire, sélectionnez Taux de span (graphique en courbes) ou Durée du span (centile), puis utilisez le menu Type de widget pour afficher un tableau. Les sélecteurs vous permettent d'afficher des données groupées ou non groupées.

    • Pour limiter les traces affichées, ajoutez des filtres.

    • Pour modifier le titre, saisissez le nouveau titre dans le champ Titre du widget.

  5. Pour appliquer vos modifications au tableau de bord, cliquez sur Appliquer dans la barre d'outils. Pour supprimer vos modifications, cliquez sur Annuler.

  6. Pour enregistrer le tableau de bord modifié, cliquez sur Enregistrer dans la barre d'outils.

Modifier un widget qui affiche des données de trace

Pour modifier un widget, pointez dessus pour activer la barre d'outils, puis cliquez sur  Modifier le widget.

Un éditeur Trace Explorer s'ouvre. Dans cette vue, vous pouvez ajouter ou supprimer des filtres, et modifier les options de configuration. Vous pouvez ensuite appliquer vos modifications à votre tableau de bord ou les ignorer.

Limites

  • Les filtres au niveau du tableau de bord ne s'appliquent pas aux widgets de trace.
  • Vous ne pouvez pas appliquer de variable à la requête d'un widget de trace.

Étapes suivantes