Ce document explique comment créer et gérer un champ d'application de trace, qui permet à la page Explorateur de traces de trouver les spans de trace que vous souhaitez afficher ou analyser. Si vous souhaitez uniquement afficher et analyser les spans qui proviennent de votre projet Google Cloud , vous n'avez pas besoin de configurer de niveaux d'accès aux traces. Toutefois, si vos données de trace sont stockées dans plusieurs projets, comme cela peut se produire lorsque vous utilisez une architecture de microservices, vous devez effectuer certaines activités de configuration pour afficher toutes les portées d'un seul projet Google Cloud .
Ce document n'explique pas comment afficher vos traces et vos spans. Pour en savoir plus à ce sujet, consultez Rechercher et explorer des traces.
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.
À propos des champs d'application de traces
Les champs d'application de trace sont des ressources persistantes au niveau du projet qui listent un ensemble de Google Cloud projets. Vous pouvez configurer la page Explorateur Trace pour effectuer une recherche par champ d'application de trace. Cela signifie que la page recherche les projets listés dans le champ d'application sélectionné. Vos rôles IAM (Identity and Access Management) dans les projets recherchés et le paramètre de plage de dates déterminent les données extraites du stockage, puis affichées.
Lorsque vous créez un projet Google Cloud , un champ d'application de trace nommé _Defaultest créé. Ce champ d'application n'inclut que le projet Google Cloud . Vous ne pouvez pas ajouter de projets à ce champ d'application ni le supprimer.
Vous pouvez créer des portées de trace, et modifier ou supprimer celles que vous créez. Vous souhaitez créer un champ d'application de trace lorsque vous disposez d'un service qui écrit des données de portée dans plusieurs projets Google Cloud .
À moins que vous n'ouvriez la page Explorateur Trace avec une URL incluant un champ d'application de trace ou un ID de trace et de span, la page Explorateur Trace recherche les données de trace dans les projetsGoogle Cloud listés dans le champ d'application de trace par défaut.
Lorsque vous créez votre projet, le champ d'application de trace nommé _Default est défini comme champ d'application de trace par défaut. Toutefois, vous pouvez sélectionner une autre portée de trace à utiliser comme portée de trace par défaut.
Applications App Hub et étendues de trace
Vos applications App Hub peuvent écrire des données de trace dans plusieurs projets. Pour obtenir une vue agrégée de ces données, créez un champ d'application de trace, configurez-le pour qu'il liste tous les projets qui stockent vos données de trace, puis configurez-le comme champ d'application de trace par défaut. Une fois ces étapes effectuées, la page Explorateur de traces affiche automatiquement les données écrites par votre application, même si elles sont stockées dans différents projets.
Créez le champ d'application de trace personnalisé dans le projet à partir duquel vous allez afficher vos données de journaux. Il s'agit soit de votre projet hôte App Hub, soit du projet de gestion de votre dossier compatible avec les applications.
Par exemple, si le nom à afficher du dossier est My Folder, celui du projet de gestion est My Folder-mp.
Avant de commencer
Pour obtenir les autorisations nécessaires pour créer et afficher des portées de trace, et pour définir la portée de trace par défaut, demandez à votre administrateur de vous accorder les rôles IAM suivants :
-
Pour créer et afficher des champs d'application de trace, et pour obtenir le champ d'application de trace par défaut :
Utilisateur Cloud Trace (
roles/cloudtrace.user) sur votre projet -
Pour définir le champ d'application de trace par défaut :
Éditeur Observabilité (
roles/observability.editor) sur votre projet
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Ces rôles prédéfinis contiennent les autorisations requises pour créer et afficher des portées de trace, et pour définir la portée de trace par défaut. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
Les autorisations suivantes sont requises pour créer et afficher des niveaux de trace, et pour définir le niveau de trace par défaut :
-
Pour créer et gérer des champs d'application de trace :
cloudtrace.traceScopes.[create, delete, get, list, update] -
Pour définir le champ d'application de trace par défaut :
observability.scopes.[get, update]
Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.
Lister les champs d'application de Trace
Pour lister les portées de trace, procédez comme suit :
-
Dans la console Google Cloud , accédez à la page settings Paramètres :
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.
- 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.
Sélectionnez l'onglet Étendues de trace.
Le tableau liste vos portées de trace. Lorsque vous avez sélectionné un projet Google Cloud , une entrée s'affiche avec une icône "Par défaut",
, qui indique qu'il s'agit du champ d'application de trace par défaut.
Lorsque la page Explorateur Trace s'ouvre, elle recherche des données de trace dans les projets listés dans le champ d'application de trace par défaut.
Créer un champ d'application de trace
Les spans affichés sur la page Explorateur Trace dépendent des projets recherchés, de vos rôles IAM dans ces projets, du paramètre de plage de temps et des filtres que vous appliquez.
Vous pouvez créer 100 portées de trace par projet. Un champ d'application de trace peut inclure un total de 20 projets.
Pour créer un champ d'application de trace, procédez comme suit :
-
Dans la console Google Cloud , accédez à la page settings Paramètres :
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.
- 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.
- Sélectionnez l'onglet Étendues de trace, puis cliquez sur Créer une étendue de trace.
Cliquez sur Ajouter des projets et remplissez la boîte de dialogue.
Lorsque vous ajoutez un projet, les spans stockés dans ce projet sont inclus dans le champ d'application de la trace. Si vous ne savez pas quels projets inclure dans un champ d'application, vous pouvez utiliser l'ancienne page Explorateur Trace pour vous aider à les identifier. Pour en savoir plus, consultez la section Migrer vers les portées de trace de ce document.
Dans la section Nommer le champ de trace, saisissez le nom et la description que vous souhaitez afficher dans l'onglet Champs de trace.
Le nom d'un champ d'application de trace ne peut pas être modifié et doit être unique dans le projet.
Cliquez sur Créer un champ d'application de trace.
Migrer vers les champs d'application de Trace
La page Explorateur Trace vous demande de spécifier les projetsGoogle Cloud dans lesquels rechercher des données de trace. Il s'agit d'un changement de comportement par rapport à l'ancienne page Explorateur Trace. L'ancienne page Explorateur Trace recherche dans tous les projets d'une organisation. En raison de ces différences, il est possible que la page Explorateur de traces n'affiche pas les portées qui s'affichent sur les anciennes pages Explorateur de traces.
Vous pouvez utiliser la section Détails des traces de l'ancienne page Explorateur Trace pour compiler une liste desGoogle Cloud projets qui stockent vos données de trace :
Accédez à l'ancienne page Explorateur Trace :
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.
Sélectionnez une trace.
Vous pouvez essayer les solutions suivantes :
- Affichez une trace en saisissant son ID dans le champ ID de trace.
- Ajouter des filtres.
Dans le volet Détails des traces, sélectionnez la trace, puis accédez à l'onglet Projets.
Cet onglet liste les projets qui stockent les spans de la trace.
Pour créer un champ d'application de trace contenant les projets listés, accédez à la barre d'outils de l'onglet Projets, sélectionnez Créer un champ d'application avec ces projets, puis remplissez la boîte de dialogue.
Répétez les étapes précédentes jusqu'à ce que vous ayez compilé une liste de projets.
Une fois que vous avez compilé une liste de projets, créez un champ d'application de trace. Vous pouvez également le définir comme champ d'application de trace par défaut.
Définir le champ d'application de trace par défaut
Lorsque la page Explorateur Trace s'ouvre, elle recherche des données de trace dans les projets listés dans le champ d'application de trace par défaut. Si ce champ d'application de trace n'est pas accessible, des données de trace sont recherchées dans votre projet.
Lorsque des projets sont créés, le champ d'application de trace nommé _Default est créé et désigné comme champ d'application de trace par défaut. Toutefois, vous pouvez créer votre propre champ d'application de trace et le désigner comme champ d'application de trace par défaut.
Pour définir le champ d'application de trace par défaut :
-
Dans la console Google Cloud , accédez à la page settings Paramètres :
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.
- 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.
- Sélectionnez l'onglet Étendues de trace.
Recherchez le champ d'application de trace que vous souhaitez définir comme champ d'application de trace par défaut, cliquez sur more_vert Plus, puis sélectionnez Définir comme valeur par défaut.
Le champ d'application de trace que vous avez sélectionné est indiqué par une icône "Par défaut",
.
Modifier ou supprimer un champ d'application de trace
Vous ne pouvez pas supprimer ni modifier le champ d'application de trace nommé _Default. Vous pouvez modifier ou supprimer tous les autres niveaux de trace.
Pour modifier ou supprimer un champ d'application de trace :
-
Dans la console Google Cloud , accédez à la page settings Paramètres :
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.
- 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.
- Sélectionnez l'onglet Étendues de trace.
Recherchez le champ d'application de la trace que vous souhaitez modifier ou supprimer, cliquez sur more_vert Plus, puis effectuez l'une des actions suivantes :
- Pour le modifier, sélectionnez Modifier le champ d'application, puis remplissez la boîte de dialogue.
- Pour supprimer une portée, sélectionnez Supprimer la portée, puis remplissez les champs de la boîte de dialogue.
Limites
L'API Cloud Trace ni Google Cloud CLI ne permettent de créer ni de gérer des portées de trace.
Étapes suivantes
Cloud Logging et Cloud Monitoring contiennent des constructions similaires qui vous permettent de contrôler les données de journaux ou les données de métriques que vous pouvez afficher ou surveiller. Pour en savoir plus sur ces niveaux d'accès, consultez les documents suivants :