Ce document explique comment créer et gérer un champ d'application de trace, qui permet à la page Trace Explorer de trouver les segments de trace que vous souhaitez afficher ou analyser. Si vous souhaitez uniquement afficher et analyser les plages issues de votre projet Google Cloud, vous n'avez pas besoin de configurer de champ d'application de trace. 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 périodes d'un seul projet Google Cloud.
Ce document n'explique pas comment afficher vos traces et vos segments. Pour en savoir plus, consultez la section Rechercher et explorer des traces.
À 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 projets Google Cloud. Vous pouvez configurer la page Explorateur Trace pour rechercher 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) sur les projets recherchés et le paramètre de période déterminent les données extraites de l'espace de stockage et affichées.
Lorsque vous créez un projet Google Cloud, un champ d'application de la trace nommé _Default est 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 vous pouvez modifier et supprimer toutes les portées de trace que vous créez. Vous souhaitez créer un champ d'application de la trace lorsque vous disposez d'un service qui écrit des données span dans plusieurs projets Google Cloud.
Sauf si vous ouvrez la page Explorateur Trace avec une URL incluant un champ d'application de trace ou un ID de trace et d'étendue, la page Explorateur Trace recherche des données de trace dans les projets Google Cloud listés dans le champ d'application de trace par défaut.
Lorsque vous créez votre projet, le champ d'application de la trace nommé _Default est défini comme champ d'application de la trace par défaut. Toutefois, vous pouvez sélectionner une autre portée de trace à utiliser comme portée de trace par défaut.
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 la trace par défaut : Éditeur d'observabilité (
roles/observability.editor) sur votre projet
Pour en savoir plus sur l'attribution de rôles, consultez la page 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 portées de trace, et pour définir la portée 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 afficher les portées de traçage, procédez comme suit:
-
Accédez à la page settings Paramètres dans la console Google Cloud.
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.
Sélectionnez l'onglet Champ d'application de la trace.
Le tableau liste vos champs d'application de la trace. Une fois que 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 de la portée 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 périodes affichées par la page Explorateur de traces dépendent des projets recherchés, de vos rôles IAM dans ces projets, du paramètre de période et des filtres que vous appliquez.
Vous pouvez créer 100 champs d'application de la 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:
-
Accédez à la page settings Paramètres dans la console Google Cloud.
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.
- Sélectionnez l'onglet Champ d'application de la trace, puis cliquez sur Créer un champ d'application de la trace.
Cliquez sur Ajouter des projets, puis remplissez la boîte de dialogue.
Lorsque vous ajoutez un projet, les périodes stockées dans ce projet sont incluses 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 de traces pour vous aider à les identifier. Pour en savoir plus, consultez la section Passer aux champs d'application de la trace de ce document.
Dans la section Nommer la portée de la trace, saisissez le nom et la description que vous souhaitez afficher dans l'onglet Portées 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 la trace.
Migrer vers les champs d'application de trace
La page Explorateur de traces vous oblige à spécifier les projets Google Cloud dans lesquels rechercher des données de trace. Il s'agit d'un changement de comportement par rapport à l'ancienne page Explorateur de traces. L'ancienne page Explorateur de traces recherche dans tous les projets d'une organisation. En raison de ces différences, la page Explorateur de traces peut ne pas afficher les plages que les anciennes pages Explorateur de traces affichent.
Vous pouvez utiliser la section du volet Détails des traces de l'ancienne page Explorateur de traces pour compiler une liste des projets Google Cloud qui stockent vos données de trace:
Accédez à l'ancienne page Explorateur de traces:
Sélectionnez une trace.
Vous pouvez essayer les solutions suivantes:
- Afficher une trace en saisissant son ID dans le champ ID de la trace.
- Ajouter des filtres.
Dans le volet Détails de la trace, sélectionnez la trace, puis accédez à l'onglet Projets.
Cet onglet liste les projets qui stockent des plages pour 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 Projects (Projets), sélectionnez Create scope with these projects (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.
Après avoir compilé une liste de projets, créez un champ d'application de la trace. Vous pouvez également le définir comme champ d'application de trace par défaut.
Définir le champ d'application de la 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 la 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 la trace nommé _Default est créé et désigné comme champ d'application de la 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 la portée de trace par défaut, procédez comme suit:
-
Accédez à la page settings Paramètres dans la console Google Cloud.
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.
- Sélectionnez l'onglet Champ d'application de la trace.
Recherchez le champ d'application de la trace que vous souhaitez désigner comme champ d'application de la trace par défaut, cliquez sur more_vert Plus, puis sélectionnez Définir comme valeur par défaut.
Le champ d'action de la trace que vous avez sélectionné est affiché avec une icône "Par défaut",
.
Modifier ou supprimer le champ d'application d'une trace
Vous ne pouvez pas supprimer ni modifier le champ d'application de la trace nommé _Default. Vous pouvez modifier ou supprimer tous les autres champs d'application de la trace.
Pour modifier ou supprimer un champ d'application de la trace, procédez comme suit:
-
Accédez à la page settings Paramètres dans la console Google Cloud.
Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.
- Sélectionnez l'onglet Champ d'application de la trace.
Recherchez la portée 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 la portée, sélectionnez Delete scope (Supprimer la portée), puis remplissez la boîte de dialogue.
Limites
L'API Cloud Trace ou la Google Cloud CLI ne permettent pas de créer ni de gérer des portées de trace.
Étape suivante
Cloud Logging et Cloud Monitoring contiennent des constructions similaires qui vous permettent de contrôler les données de journal ou les données métriques que vous pouvez afficher ou surveiller. Pour en savoir plus sur ces champs d'application, consultez les documents suivants: