Questo documento descrive l'API Telemetry (OTLP), che implementa il protocollo OpenTelemetry OTLP. Questa API è progettata per l'utilizzo con applicazioni instrumentate utilizzando uno degli SDK OpenTelemetry.
Perché dovresti utilizzare l'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 dei dati di traccia.
Quando utilizzi l'API Telemetry, i tuoi dati vengono archiviati in un formato generalmente coerente con i file proto definiti dal protocollo OpenTelemetry OTLP. Tuttavia, i campi potrebbero essere convertiti da un tipo di dati specifico di OpenTelemetry a un tipo di dati JSON prima dell'archiviazione. Inoltre, si applicano i limiti per l'API Telemetry. Questi limiti sono spesso più generosi di quelli dell'Cloud Trace API. Infine, la strumentazione non si basa su un esportatore specifico per Google Cloud.
Per saperne di più sul formato di archiviazione, consulta Schema per i dati di traccia.
Quando utilizzare l'API Telemetry
Quando strumenti 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 tracciamento all'API Telemetry.
- Utilizza un esportatore OTLP in-process supportato da una libreria OpenTelemetry che invia dati di telemetria all'API Telemetry. Non esiste alcun raccoglitore con questa configurazione.
Per informazioni su come utilizzare l'API Telemetry, consulta Eseguire la migrazione dall'esportatore Cloud Trace all'endpoint OTLP.
Dove visualizzare i dati importati
I dati di Trace importati tramite l'API Telemetry possono essere visualizzati utilizzando la pagina Esplora tracce. Per informazioni su come visualizzare i dati di traccia, consulta Trovare ed esplorare le tracce.
Autenticazione
Gli esportatori devono essere autorizzati a inviare dati al tuo progetto Google Cloud . Ad esempio, puoi configurare l'esportatore con le tue Google Cloud credenziali predefinite dell'applicazione (ADC) aggiungendo una libreria di autenticazione Google specifica per la lingua alla tua applicazione. Per ulteriori informazioni e codice campione, consulta Configurare l'autenticazione.
Supporto dei Controlli di servizio VPC
Il servizio API Telemetry, il cui nome è telemetry.googleapis.com, è un servizio supportato dai Controlli di servizio VPC. Le eventuali limitazioni dei Controlli di servizio VPC
che crei per il servizio API Telemetry si applicano
solo a quel servizio. Queste limitazioni non si applicano ad altri servizi, inclusi quelli come il servizio cloudtrace.googleapis.com, che possono anche importare dati di traccia.
Per ulteriori informazioni, consulta le seguenti risorse: