Cette page vous guide à travers les étapes suivantes:
- Installez les packages OpenTelementry.
- Configurez votre application pour exporter les délais vers Cloud Trace.
- Configurez votre plate-forme.
Pour en savoir plus sur les versions, consultez les articles suivants :
Pour obtenir du contenu de référence sur OpenTelemetry, consultez les ressources suivantes :
Pour en savoir plus sur OpenTelemetry pour C++, consultez ainsi que de la documentation et des exemples supplémentaires, consultez OpenTelemetry.
Avant de commencer
Enable the Cloud Trace API.
Installer les packages OpenTelementry
- Configurez un environnement de développement C++.
- Installez la bibliothèque d'exportation OpenTelemetry Google Cloud C++. Pour d'installation, consultez la Guide de démarrage rapide d'OpenTelemetry.
Configurer l'exportation des délais vers Cloud Trace
Pour configurer l'exportation des données de trace, appelez la méthode
Méthode google::cloud::otel::ConfigureBasicTracing(...)
dans votre main()
méthode:
Le champ project_id
correspond au projet Google Cloud dans lequel vous souhaitez stocker les traces.
La méthode ConfigureBasicTracing(...)
instancie un
Objet TracerProvider
qui implémente
comme exportateur Cloud Trace. Si l'objet renvoyé par l'appel à ConfigureBasicTracing(...)
sort du champ d'application, l'objet TracerProvider
précédent est rétabli, le cas échéant.
Configurer le taux d'échantillonnage
Les applications peuvent générer un grand volume de données de trace. Les éléments suivants : montre comment configurer le taux d'échantillonnage:
Exporter vers Cloud Trace avec un fichier TracerProvider
personnalisé
Certains cas d'utilisation peuvent nécessiter un objet TracerProvider
personnalisé. Pour
Par exemple, si vous souhaitez utiliser plusieurs exportateurs en même temps,
pour créer un objet TracerProvider
personnalisé. Dans ce cas, vous pouvez utiliser
Exportateur Cloud Trace directement:
Instrumenter votre propre application
Pour en savoir plus sur la configuration de votre application pour capturer des délais de trace, consultez la page Traçage OpenTelemetry. Cette page explique comment effectuer les opérations suivantes :
- Créer un délai
- Créer des délais imbriqués
- Définir des attributs de délai
- Créer des délais avec des événements
- Créer des délais avec des liens
Exemple d'application
Pour voir un exemple d'application, consultez dans le guide de démarrage rapide.
Configurer votre plate-forme
Vous pouvez utiliser Cloud Trace sur Google Cloud et d'autres plates-formes.
Exécuter des applications sur Google Cloud
Lorsque votre application s'exécute sur Google Cloud, vous n'avez pas besoin de fournir des identifiants d'authentification sous la forme d'un compte de service à la bibliothèque cliente. Cependant, vous devez vous assurer que Google Cloud Platform dispose des Champ d'application de l'accès à l'API Cloud Trace est activé.
Pour obtenir la liste des environnements Google Cloud compatibles, consultez la page Environnements compatibles.
Pour les configurations suivantes, les paramètres de niveau d'accès par défaut activent l'API Cloud Trace :
- Environnement flexible App Engine
Environnement standard App Engine
Google Kubernetes Engine (GKE)
Compute Engine
Cloud Run
Si vous utilisez des niveaux d'accès personnalisés, assurez-vous que Champ d'application de l'accès à l'API Cloud Trace est activé:
Pour en savoir plus sur la configuration des niveaux d'accès pour votre environnement à l'aide de Google Cloud Console, consultez la section Configurer votre projet Google Cloud.
Pour les utilisateurs
gcloud
, spécifiez les niveaux d'accès à l'aide de l'indicateur--scopes
et incluez le niveau d'accès à l'API Cloud Tracetrace.append
. Par exemple, pour créer un cluster GKE avec uniquement l'API Cloud Trace activée, procédez comme suit :gcloud container clusters create example-cluster-name --scopes=https://www.googleapis.com/auth/trace.append
Exécuter en local et depuis un autre emplacement
Si votre application s'exécute en dehors de Google Cloud, vous devez fournir les identifiants d'authentification sous la forme d'un compte de service à la bibliothèque cliente. Le compte de service doit contenir le rôle d'agent Cloud Trace. Pour savoir comment faire, consultez la page Créer un compte de service.
Les bibliothèques clientes Google Cloud utilisent les identifiants par défaut de l'application (ADC) pour trouver les identifiants de votre application.
Vous pouvez fournir ces identifiants de l'une des trois manières suivantes :
Exécuter
gcloud auth application-default login
Placez le compte de service dans un chemin d'accès par défaut pour votre système d'exploitation. Vous trouverez ci-dessous les chemins d'accès par défaut pour Windows et Linux :
Windows :
%APPDATA%/gcloud/application_default_credentials.json
Linux :
$HOME/.config/gcloud/application_default_credentials.json
Définissez la variable d'environnement
GOOGLE_APPLICATION_CREDENTIALS
sur le chemin d'accès à votre compte de service :
Linux/macOS
export GOOGLE_APPLICATION_CREDENTIALS=path-to-your-service-accounts-private-key
Windows
set GOOGLE_APPLICATION_CREDENTIALS=path-to-your-service-accounts-private-key
Powershell :
$env:GOOGLE_APPLICATION_CREDENTIALS="path-to-your-service-accounts-private-key"
Afficher les traces
Dans la console Google Cloud, accédez à la page Explorateur Trace.
Vous pouvez également accéder à cette page à l'aide de la barre de recherche.
Dépannage
Pour en savoir plus sur la résolution des problèmes liés à Cloud Trace, consultez la page Dépannage.
Pour déboguer l'exportateur Cloud Trace C++, consultez la section Dépannage de la documentation de référence.
Ressources
- https://opentelemetry.io/
- Dépôt GitHub open-telemetry/opentelemetry-cpp
- google-cloud-cpp OpenTelemetry Exporters Library dépôt GitHub.