Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Importante
Questa funzionalità è in versione beta.
Zerobus Ingest OTLP è un endpoint nativo OpenTelemetry Protocol (OTLP) integrato nel servizio Zerobus Ingest. Consente di eseguire il push di tracce, log e metriche direttamente nelle tabelle Delta del catalogo Unity usando gli SDK e gli agenti di raccolta OpenTelemetry standard, senza bisogno di librerie personalizzate.
Per configurare il client OTLP per l'invio di dati a Zerobus Ingest, vedere Configurare client OpenTelemetry (OTLP) per l'invio di dati a Unity Catalog.
Concetti
I concetti seguenti sono utili per comprendere il funzionamento di Zerobus Ingest OTLP.
Compatibilità OTLP
Zerobus Ingest OTLP implementa i servizi standard del Collector OTLP gRPC come definito dalla specifica OpenTelemetry. Qualsiasi utilità di esportazione compatibile con OTLP (ad esempio Gli SDK OpenTelemetry, OpenTelemetry Collector o altre librerie di strumentazione) può inviare dati a questo endpoint.
Segnali supportati
Zerobus Ingest OTLP espone tre servizi OTLP/gRPC , uno per tipo di segnale di telemetria:
| Segnale | Percorso del servizio gRPC |
|---|---|
| Tracce: Tracce distribuite con supporto completo per eventi, collegamenti e stato. | /opentelemetry.proto.collector.trace.v1.TraceService/Export |
Log: registri di log con gravità, contenuto e correlazione alle tracce tramite trace_id e span_id. |
/opentelemetry.proto.collector.logs.v1.LogsService/Export |
| Metriche: tutti e cinque i tipi di metrica OTLP: misuratore, somma, istogramma, esponenziali e riepilogo. | /opentelemetry.proto.collector.metrics.v1.MetricsService/Export |
Esito positivo parziale
Zerobus Ingest OTLP supporta il successo parziale, come definito dalla specifica OTLP. Se una richiesta contiene una combinazione di record validi e non validi, i record validi vengono inseriti e i record non validi vengono rifiutati. La risposta include il numero di record rifiutati (rejected_spans, rejected_log_records, o rejected_data_points) e un error_message che descrive il motivo.
Compression
La compressione Gzip è supportata in tutti e tre i servizi OTLP. Impostare l'intestazione su grpc-encodingo configurare l'utilità gzip di esportazione OTLP per l'uso della compressione gzip.
Limitazioni
- È supportato solo il trasporto OTLP/gRPC (Protobuf). HTTP (Protobuf) non è ancora supportato.
- Ogni richiesta è destinata a una tabella, specificata usando l'intestazione
x-databricks-zerobus-table-name. Per inserire tracce, log e metriche, configurare esportatori separati, ognuno dei quali punta a tabelle diverse. - Le tabelle devono essere create in anticipo con lo schema corretto. L'inserimento Zerobus non crea o modifica le tabelle.
- La quota predefinita è 10.000 richieste al secondo. Se è necessaria una quota più elevata, contattare il rappresentante di Databricks.
- Per un elenco completo delle limitazioni del connettore Zerobus Ingest, vedere Limitazioni del connettore Zerobus Ingest.
Passaggi successivi
- Configurare i client OpenTelemetry (OTLP) per inviare dati a Unity Catalog: esempi di Python e configurazione dell'agente di raccolta OpenTelemetry.
- Riferimento alla tabella OpenTelemetry per Zerobus Ingest — Schemi di tabella e riferimento al mapping dei dati.
- Eseguire query sui dati OpenTelemetry : query SQL di esempio per intervalli, log e metriche.
- Limitazioni del connettore Zerobus Ingest