Partager des traces et des plages

Ce document explique comment partager avec une autre personne ou un autre groupe les données que vous consultez sur la page Explorateur de traces. Par exemple, vous pouvez remarquer une anomalie ou une tendance dans vos données de trace et souhaiter qu'une autre personne examine ces données plus en détail. Il peut également y avoir des erreurs ou des valeurs de latence inattendues dans une trace ou une étendue individuelle que vous souhaitez que quelqu'un examine.

Cette fonctionnalité n'est disponible que pour les projets Google Cloud . Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.

Bonne pratique

Pour faciliter le dépannage, nous vous recommandons d'attribuer le rôle Utilisateur Cloud Trace (roles/cloudtrace.user) à toutes les personnes, tous les groupes et tous les domaines qui pourraient avoir besoin d'afficher les données de trace dans un projet. Ce rôle accorde aux principaux les autorisations dont ils ont besoin pour afficher les données de trace.

Avant de commencer

Pour obtenir les autorisations nécessaires pour afficher les données de trace à l'aide de la console Google Cloud , demandez à votre administrateur de vous accorder le rôle IAM Utilisateur Cloud Trace (roles/cloudtrace.user) sur les projets qui stockent vos données de trace. 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.

Partager des données de trace

Lorsque vous utilisez la page Explorateur Trace pour explorer vos données de trace, les sélections que vous effectuez mettent à jour l'URL dans votre navigateur. Par exemple, si vous ajoutez des filtres ou définissez la plage de dates, l'URL de la page est modifiée. De même, si vous sélectionnez une période ou une trace, l'URL est mise à jour pour inclure l'ID de période et l'ID de trace.

Par conséquent, pour partager les données que vous consultez avec une autre personne, copiez l'URL de la page et partagez-la. Lorsque le destinataire colle l'URL dans son navigateur, les paramètres qu'elle contient remplacent tous les paramètres par défaut de la page Explorateur Trace. Les données affichées dépendent des rôles IAM du destinataire dans les projets référencés par l'URL.

Pour partager des données de trace, 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 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 du dossier compatible avec les applications.

  3. Configurez la page Explorateur Trace pour afficher les données que vous souhaitez partager.

    Par exemple, vous pouvez ajouter des filtres, mettre à jour le sélecteur de plage de dates ou modifier l'élément Champ d'application, qui contrôle les projets dans lesquels les données de trace sont recherchées.

    Si le premier menu de l'élément Champ d'application est défini sur Projet ou sur _Par défaut, les données de trace sont recherchées dans votre projet. Sinon, la recherche s'effectue dans les projets listés dans le champ d'application de la trace. Pour en savoir plus, consultez Créer et gérer des champs d'application de trace.

    Si vous souhaitez partager l'URL d'une trace ou d'une étendue, ouvrez le menu Détails de cette trace ou de cette étendue en procédant de l'une des manières suivantes :

    • Dans la barre d'outils, cliquez sur Rechercher une trace, puis saisissez l'ID de la trace.

    • Recherchez et sélectionnez une plage.

  4. Copiez l'URL dans votre navigateur, puis partagez-la.

Résoudre les problèmes

Pour savoir comment résoudre les problèmes, comme les traces sans spans ou l'absence de données sur la page Explorateur Trace, consultez la section Dépannage.

Étapes suivantes