Freigeben über

Aufnehmen von OpenTelemetry-Daten mit Zerobus Ingest

Von Bedeutung

Dieses Feature befindet sich in der Betaversion.

Zerobus Ingest OTLP ist ein nativer OpenTelemetry Protocol (OTLP) -Endpunkt, der in den Zerobus Ingest-Dienst integriert ist. Damit können Sie Traces, Protokolle und Metriken direkt in Unity Catalog Delta-Tabellen mit standardmäßigen OpenTelemetry-SDKs und -Sammlern einspeisen, ohne benutzerdefinierte Bibliotheken zu benötigen.

Informationen zum Konfigurieren Ihres OTLP-Clients zum Senden von Daten an Zerobus Ingest finden Sie unter Configure OpenTelemetry (OTLP)-Clients zum Senden von Daten an den Unity-Katalog.

Konzepte

Die folgenden Konzepte sind nützlich, um zu verstehen, wie Zerobus Ingest OTLP funktioniert.

OTLP-Kompatibilität

Zerobus Ingest OTLP implementiert die standardmäßigen OTLP gRPC Collector-Dienste gemäß der OpenTelemetry-Spezifikation. Jeder OTLP-kompatible Exporter (z. B. OpenTelemetry-SDKs, der OpenTelemetry Collector oder andere Instrumentationsbibliotheken) kann Daten an diesen Endpunkt senden.

Unterstützte Signale

Zerobus Ingest OTLP macht drei OTLP/gRPC-Dienste verfügbar, eine pro Telemetriesignaltyp :

Signal gRPC-Dienstpfad
Ablaufverfolgungen: Verteilte Ablaufverfolgung umfasst vollständige Unterstützung für Ereignisse, Links und Status. /opentelemetry.proto.collector.trace.v1.TraceService/Export
Protokolle: Protokolldatensätze mit Schweregrad, Inhalt und Korrelation mit Ablaufverfolgungen über trace_id und span_id. /opentelemetry.proto.collector.logs.v1.LogsService/Export
Metriken: Alle fünf OTLP-Metriktypen: Gauge, Sum, Histogramm, ExponentialHistogram und Zusammenfassung. /opentelemetry.proto.collector.metrics.v1.MetricsService/Export

Teilerfolg

Zerobus Ingest OTLP unterstützt teilweisen Erfolg gemäß der OTLP-Spezifikation. Wenn eine Anforderung eine Mischung aus gültigen und ungültigen Datensätzen enthält, werden die gültigen Datensätze aufgenommen, und die ungültigen Datensätze werden abgelehnt. Die Antwort enthält die Anzahl der abgelehnten Datensätze (rejected_spans, rejected_log_recordsoder rejected_data_points) und eine error_message Beschreibung, warum.

Compression

Die Gzip-Komprimierung wird für alle drei OTLP-Dienste unterstützt. Legen Sie den grpc-encoding Header auf gzipoder konfigurieren Sie Ihren OTLP-Exporter für die Verwendung der Gzip-Komprimierung.

Einschränkungen

  • Nur der OTLP/gRPC (Protobuf)-Transport wird unterstützt. HTTP (Protobuf) wird noch nicht unterstützt.
  • Jede Anforderung zielt auf eine Tabelle ab, die mit der x-databricks-zerobus-table-name Kopfzeile angegeben wird. Um Traces, Protokolle und Metriken aufzunehmen, konfigurieren Sie separate Exporter, die auf verschiedene Tabellen verweisen.
  • Tabellen müssen im Voraus mit dem richtigen Schema erstellt werden. Zerobus Ingest erstellt oder ändert keine Tabellen.
  • Das Standardkontingent beträgt 10.000 Anforderungen pro Sekunde. Wenn Sie ein höheres Kontingent benötigen, wenden Sie sich an Ihren Databricks-Vertreter.
  • Eine vollständige Liste der Einschränkungen von Zerobus Ingest finden Sie unter Zerobus Ingest Connector-Einschränkungen.

Nächste Schritte

  • Last updated on