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 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 le niveau d'accès de l'API Cloud Trace est activé :
Pour en savoir plus sur la configuration des niveaux d'accès pour votre environnement à l'aide de la console Google Cloud, consultez la page 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. Voici la liste des 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
pour qu'elle indique 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"
Exemple d'application
Afficher les traces
Dans le panneau de navigation de la console Google Cloud, sélectionnez Trace, puis Explorateur Trace:
Dépannage
Pour en savoir plus sur la résolution des problèmes liés à Cloud Trace, consultez la page Dépannage.