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.
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.
Azure Databricks fattura l'ingestione OTLP come utilizzo di Zerobus Ingest. Per i prezzi e come monitorare la spesa, vedi Costo.
Concetti
I concetti seguenti sono utili per comprendere il funzionamento di Zerobus Ingest OTLP.
Compatibilità OTLP
Zerobus Ingest OTLP implementa i servizi standard OTLP Collector come definiti dalla specifica OpenTelemetry, sia su gRPC che su HTTP (Protobuf). Qualsiasi esportatore compatibile OTLP, come un SDK OpenTelemetry, l'OpenTelemetry Collector o un'altra libreria di strumentazione, può inviare dati a questo endpoint.
Segnali supportati
Zerobus Ingest OTLP espone un servizio per ogni tipo di segnale di telemetria. Ogni segnale è disponibile sia su OTLP/gRPC che OTLP/HTTP (Protobuf):
| Segnale | Percorso del servizio gRPC | Percorso HTTP |
|---|---|---|
| Tracce: Tracce distribuite con supporto completo per eventi, collegamenti e stato. | /opentelemetry.proto.collector.trace.v1.TraceService/Export |
/v1/traces |
Log: registri di log con gravità, contenuto e correlazione alle tracce tramite trace_id e span_id. |
/opentelemetry.proto.collector.logs.v1.LogsService/Export |
/v1/logs |
| Metriche: tutti e cinque i tipi di metrica OTLP: misuratore, somma, istogramma, esponenziali e riepilogo. | /opentelemetry.proto.collector.metrics.v1.MetricsService/Export |
/v1/metrics |
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 su tutti e tre i servizi OTLP, sia su gRPC che su HTTP. Per gRPC, imposta l'intestazione grpc-encoding su gzip. Per HTTP, imposta l'intestazione Content-Encoding su gzip. In alternativa, configura il tuo esportatore OTLP per usare la compressione gzip.
Limitazioni
- È supportata solo la codifica Protobuf di OTLP/HTTP. OTLP/HTTP con corpo JSON non è supportato, e le richieste con un
Content-Typediapplication/jsonvengono rifiutate. - 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.
- Alcuni campi numerici OTLP possono perdere precisione o causare un overflow quando vengono mappati sui tipi Delta. Vedi Precisione numerica e tipi con segno.
- Per l'elenco completo delle quote di Zerobus Ingest, vedi Quote di Zerobus Ingest.
Risorse aggiuntive
- 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.
- Quote di ingestimento di Zerobus