Příjem dat OpenTelemetry pomocí Zerobus Ingest

Důležité

Tato funkce je v beta verzi.

Zerobus Ingest OTLP je nativní koncový bod protokolu OTLP (OpenTelemetry Protocol) integrovaný do služby Zerobus Ingest . Umožňuje odesílat trasovací data, logy a metriky přímo do tabulek Unity Catalog Delta pomocí standardních sad OpenTelemetry SDK a kolektorů bez nutnosti vlastních knihoven.

Pokud chcete nakonfigurovat klienta OTLP tak, aby odesílal data do Ingestu Zerobus, přečtěte si téma Konfigurace klientů OpenTelemetry (OTLP) pro odesílání dat do katalogu Unity.

Koncepty

Následující koncepty jsou užitečné pro pochopení toho, jak funguje OTLP Zerobus Ingest.

Kompatibilita OTLP

Zerobus Ingest OTLP implementuje standardní služby OTLP gRPC Collector definované specifikací OpenTelemetry. Jakýkoli vývozce kompatibilní s OTLP (například sady SDK OpenTelemetry, kolekce OpenTelemetry nebo jiné knihovny instrumentace) může odesílat data do tohoto koncového bodu.

Podporované signály

Zerobus Ingest OTLP zveřejňuje tři služby OTLP/gRPC , jednu na typ signálu telemetrie:

Signál Cesta ke službě gRPC
Trasování: Distribuované trasování zahrnuje plnou podporu událostí, odkazů a stavu. /opentelemetry.proto.collector.trace.v1.TraceService/Export
Logy: Záznamy logů se závažností, obsahem a propojením s trasováním prostřednictvím trace_id a span_id. /opentelemetry.proto.collector.logs.v1.LogsService/Export
Metriky: Všech pět typů metrik OTLP: Měřidlo, Součet, Histogram, ExponentialHistogram a Souhrn. /opentelemetry.proto.collector.metrics.v1.MetricsService/Export

Částečný úspěch

Zerobus Ingest OTLP podporuje částečný úspěch definovaný specifikací OTLP. Pokud požadavek obsahuje kombinaci platných a neplatných záznamů, platné záznamy se ingestují a neplatné záznamy se zamítnou. Odpověď zahrnuje počet odmítnutých záznamů (rejected_spans, rejected_log_recordsnebo rejected_data_points) a error_message popisující důvod.

Komprese

Komprese Gzip je podporována u všech tří služeb OTLP. Nastavte hlavičku grpc-encoding na gziphodnotu nebo nakonfigurujte vývozce OTLP tak, aby používal kompresi gzip.

Omezení

  • Podporuje se pouze přenos OTLP/gRPC (Protobuf). Protokol HTTP (Protobuf) se zatím nepodporuje.
  • Každý požadavek cílí na jednu tabulku zadanou pomocí hlavičky x-databricks-zerobus-table-name . Pro ingestování souborů tras, protokolů a metrik nakonfigurujte samostatné exportéry odkazující na různé tabulky.
  • Tabulky musí být vytvořeny předem se správným schématem. Nubus Ingest nevytváří ani neupravuje tabulky.
  • Výchozí kvóta je 10 000 požadavků za sekundu. Pokud potřebujete vyšší kvótu, obraťte se na zástupce Databricks.
  • Pro úplný seznam omezení ingestu Zerobusu se podívejte na Omezení konektoru Ingestu Zerobusu.

Další zdroje informací

  • Last updated on