Configurare la raccolta delle tracce utilizzando OpenTelemetry

Questo documento mostra come configurare il monitoraggio lato client ed end-to-end utilizzando OpenTelemetry. Prima di poter attivare il monitoraggio end-to-end, devi configurare il monitoraggio lato client. Per saperne di più, consulta Panoramica della raccolta di tracce.

Prima di iniziare

• Per assicurarti che il account di servizio utilizzato dalla tua applicazione disponga delle autorizzazioni necessarie per configurare la raccolta di tracce, chiedi all'amministratore di concedere i seguenti ruoli IAM al account di servizio utilizzato dalla tua applicazione nel tuo progetto:

  • Tutti: Cloud Telemetry Traces Writer (roles/telemetry.tracesWriter)

• Verifica che le API Cloud Trace e Telemetry siano abilitate nel tuo progetto. Per saperne di più sull'abilitazione delle API, consulta Abilitare le API.

Configurare il monitoraggio lato client

Per esportare le tracce utilizzando OpenTelemetry Protocol (OTLP), configura la tua applicazione. Puoi inviare i dati a un OpenTelemetry Collector o direttamente a Cloud Trace tramite l'API Telemetry API. Entrambi i metodi utilizzano le stesse dipendenze e la stessa configurazione. Differiscono solo nell'endpoint OTLP utilizzato dall'esportatore.

Esportare le tracce utilizzando OpenTelemetry Protocol

Per esportare le tracce utilizzando OpenTelemetry Protocol, configura l'SDK OpenTelemetry e l'esportatore OTLP:

1. Aggiungi le dipendenze necessarie alla tua applicazione utilizzando il seguente codice:

   Java

   <dependency>
     <groupId>com.google.cloud</groupId>
     <artifactId>google-cloud-spanner</artifactId>
   </dependency>
   <dependency>
     <groupId>io.opentelemetry</groupId>
     <artifactId>opentelemetry-sdk</artifactId>
   </dependency>
   <dependency>
     <groupId>io.opentelemetry</groupId>
     <artifactId>opentelemetry-sdk-trace</artifactId>
   </dependency>
   <dependency>
     <groupId>io.opentelemetry</groupId>
     <artifactId>opentelemetry-exporter-otlp</artifactId>
   </dependency>

   Vai

   go.opentelemetry.io/otel v1.28.0
   go.opentelemetry.io/otel/sdk v1.28.0
   go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracegrpc v1.28.0

   Node.js

   "@opentelemetry/exporter-trace-otlp-grpc": "^0.57.0",
   "@opentelemetry/sdk-trace-base": "^1.26.0",
   "@opentelemetry/sdk-trace-node":