Questo documento descrive l'API Telemetry (OTLP), che implementa il protocollo OpenTelemetry OTLP. Questa API è progettata per essere utilizzata con le applicazioni instrumentate utilizzando uno degli SDK OpenTelemetry.
Perché utilizzare l'API Telemetry
L'API Telemetry supporta l'importazione dei dati di traccia nel formato OTLP. Quando utilizzi l'API Telemetry, i tuoi dati vengono memorizzati nel formato OTLP senza mai essere convertiti in un formato proprietario e si applicano i limiti per l'API Telemetry. Questi limiti sono spesso più generosi di quelli per l'API Cloud Trace. Infine, la tua strumentazione non si basa su un esportatore specifico per Google Cloud.
OpenTelemetry è un progetto open source supportato da Google Cloudcon un team di ingegneri dedicato a garantire l'assistenza per l'importazione e la visualizzazione dei dati delle tracce. Google Cloud
Quando utilizzare l'API Telemetry
Quando esegui l'instrumentazione delle applicazioni per inviare i dati di traccia al tuo progetto Google Cloud, ti consigliamo di procedere nel seguente modo:
- Utilizza un esportatore che scrive OTLP in un raccoglitore, che poi invia i dati delle tracce all'API Telemetry.
- Utilizza un esportatore OTLP in-process supportato da una libreria OpenTelemetry che invia la telemetria all'API Telemetry. Non è presente 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 traccia 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.
Dati di traccia importati tramite la pagina Trace Explorer precedente dell'API Telemetry. Per ulteriori informazioni, consulta Trace Explorer precedente: problemi noti.
Supporto dei Controlli di servizio VPC
Il servizio API Telemetry, il cui nome è telemetry.googleapis.com, è un servizio supportato da VPC Service Controls. 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 i dati traccia.
Per ulteriori informazioni, consulta le seguenti risorse: