Questo documento descrive perché ti consigliamo di inviare i dati di traccia al tuo progettoGoogle Cloud utilizzando l'API Telemetry (OTLP), che implementa il protocollo OpenTelemetry OTLP. Fornisce inoltre indicazioni sull'instrumentazione delle applicazioni e su dove visualizzare i dati di traccia. Puoi utilizzare l'API Telemetry quando strumenti le tue applicazioni utilizzando uno degli SDK OpenTelemetry o quando utilizzi un raccoglitore OpenTelemetry.
Consigliamo l'API Telemetry per il seguente motivo:
L'API offre compatibilità con l'ecosistema open source OpenTelemetry e i suoi limiti sono spesso più generosi di quelli dell'Cloud Trace API, che è un'API proprietaria Google Cloud .
I dati di traccia vengono archiviati in un formato generalmente coerente con i file proto definiti dal protocollo OpenTelemetry OTLP. Alcuni campi potrebbero essere convertiti da un tipo di dati specifico di OpenTelemetry a un tipo di dati JSON prima dell'archiviazione. Per saperne di più sul formato di archiviazione, consulta Schema per i dati di traccia.
La tua strumentazione non si basa su un esportatore specifico per Google Cloud.
Alcune funzionalità, come il monitoraggio delle applicazioni, si basano su informazioni disponibili solo quando invii i dati di traccia all'API Telemetry.
OpenTelemetry è un progetto open source supportato da Google Cloudcon ingegneri Google Cloud assegnati per garantire il supporto per l'importazione e la visualizzazione della telemetria.
Best practice
Quando instrumenti le tue applicazioni per inviare dati di traccia al tuo progettoGoogle Cloud , ti consigliamo di procedere in uno dei seguenti modi:
- Utilizza un esportatore che scrive OTLP in un raccoglitore, che poi invia i dati di traccia all'API Telemetry.
- Utilizza un esportatore OTLP in-process supportato da una libreria OpenTelemetry che invia dati di telemetria all'API Telemetry. Non esiste un raccoglitore con questa configurazione.
Per informazioni su come utilizzare l'API Telemetry, consulta Eseguire la migrazione dall'esportatore Cloud Trace all'endpoint OTLP.
Autenticazione
Devi configurare gli esportatori con le credenziali necessarie per inviare i dati di traccia al tuo progetto Google Cloud . Ad esempio, per configurare l'esportatore con le tue Google Cloud Credenziali predefinite dell'applicazione (ADC), aggiungi una libreria di autenticazione Google specifica per la lingua alla tua applicazione. Per ulteriori informazioni e codice campione, consulta Configurare l'autenticazione.
Cloud Trace e localizzazione dei dati
Se utilizzi Assured Workloads perché hai requisiti di residenza dei dati o Impact Level 4 (IL4), non utilizzare l'API Telemetry per inviare gli intervalli di traccia al tuo progetto.
Dove visualizzare i dati importati
Puoi visualizzare i dati di traccia utilizzando le pagine Esplora trace e Analisi dei log. Per informazioni, consulta le seguenti risorse: