Questo documento descrive perché ti consigliamo di inviare i dati di traccia al tuo Google Cloud progetto utilizzando l'API Telemetry (OTLP), che implementa il protocollo OpenTelemetry OTLP. Fornisce inoltre indicazioni su come instrumentare le applicazioni e su dove visualizzare i dati di traccia. Puoi utilizzare l' API Telemetry quando instrumenti le applicazioni utilizzando uno degli SDK OpenTelemetry o quando utilizzi un agente di raccolta OpenTelemetry.
Ti consigliamo di utilizzare l'API Telemetry per i seguenti motivi:
L'API fornisce la compatibilità con l'ecosistema OpenTelemetry open source e i suoi limiti sono spesso più generosi di quelli dell' API Cloud Trace, 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 Google Cloud-esportatore specifico.
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 Google Cloudcon Google Cloud ingegneri che garantiscono il supporto per l'importazione e la visualizzazione della telemetria.
Google Cloud Observability verifica che l'Cloud Trace API sia abilitata nel tuo Google Cloud progetto prima di archiviare i dati di traccia. Ciò significa che se disabiliti l'Cloud Trace API, Google Cloud Observability ignora i dati di traccia che invii all'API Telemetry.
Best practice
Quando instrumenti le applicazioni per inviare i dati di traccia al tuo Google Cloud progetto, ti consigliamo di eseguire una delle seguenti operazioni:
- Utilizza un esportatore che scrive OTLP in un agente di raccolta, che a sua volta invia i dati di traccia all'API Telemetry.
- Utilizza un esportatore OTLP in-process supportato da una libreria OpenTelemetry che invia la 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 Google Cloud progetto. Ad esempio, per configurare l'esportatore con le 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 residenza dei dati
Se utilizzi Assured Workloads perché hai requisiti di residenza dei dati o livello di impatto 4 (IL4) requisiti, 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 tracce e Analisi di osservabilità. Per informazioni, consulta le seguenti risorse: