Vous pouvez activer Cloud Trace pour les applications Node.js à l'aide de la bibliothèque Cloud Trace pour Node.js.
Installer la bibliothèque cliente
Avant d'installer la bibliothèque Cloud Trace pour Node.js, assurez-vous d'avoir préparé votre environnement pour le développement Node.js.
Pour installer la bibliothèque Cloud Trace pour Node.js, utilisez npm :
npm install --save @google-cloud/trace-agent
Importez la bibliothèque Cloud Trace pour Node.js en haut du script principal ou du point d'entrée de votre application avant tout autre code :
Pour en savoir plus ou pour signaler des problèmes liés à la bibliothèque Cloud Trace pour Node.js, consultez le dépôt GitHub cloud-trace-nodejs
de l'agent.
Configurer la bibliothèque cliente
Vous pouvez personnaliser le comportement de la bibliothèque Cloud Trace pour Node.js. Consultez la configuration de la bibliothèque sur GitHub pour obtenir la liste des options de configuration que vous pouvez transmettre à la méthode start
de la bibliothèque à l'aide d'un objet options
.
L'exemple suivant montre comment spécifier l'ID du projet Google Cloud et définir le chemin d'accès à votre fichier d'identifiants. Ces deux instructions sont facultatives lorsque vous utilisez Google Cloud :
Si vous utilisez une infrastructure Google Cloud, vous n'avez pas besoin de définir projectId
sur votre ID de projet Google Cloud. Si vous ne définissez pas ce champ, la bibliothèque cliente pour Node.js collecte automatiquement ces données à partir d'un serveur de métadonnées Google Cloud.
Si vous n'exécutez pas sur l'infrastructure Google Cloud, vous devez fournir l'ID de votre projet Google Cloud à votre application.
Quelle que soit votre infrastructure, pour Node.js, lorsque vous ne définissez pas explicitement l'ID du projet Google Cloud, la bibliothèque cloud-trace-nodejs
détermine automatiquement si la variable d'environnement GCLOUD_PROJECT
est définie et, le cas échéant, utilise la valeur de GCLOUD_PROJECT
comme ID de projet Google Cloud. Pour en savoir plus sur le fichier de découverte, accédez à cloud-trace-nodejs/src/index
.
Pour définir la variable d'environnement, procédez comme suit :
Linux ou macOS
export GCLOUD_PROJECT=your-project-id
Windows
set GCLOUD_PROJECT=your-project-id
Powershell :
$env:GCLOUD_PROJECT="your-project-id"
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 le niveau d'accès de l'API Cloud Trace est activé sur votre plate-forme Google Cloud.
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
Si vous utilisez des niveaux d'accès personnalisés, assurez-vous que le niveau d'accès de l'API Cloud Trace est activé. 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 Trace trace.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 fournissez ces identifiants en définissant la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS
:
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"
Exemple d'application
Afficher les traces
Après le déploiement, vous pouvez afficher les traces dans la visionneuse de traces de Cloud Console.
Accéder à la page Lecteur de traces
Dépannage
Pour en savoir plus sur la résolution des problèmes liés à Cloud Trace, consultez la page Dépannage.