Ta emot OpenTelemetry-data med Zerobus-ingestering

Zerobus Ingest OTLP är en inbyggd Slutpunkt för OpenTelemetry Protocol (OTLP) som är inbyggd i Zerobus Ingest-tjänsten . Med den kan du skicka spårningar, loggar och mått direkt till Delta-tabeller i Unity Catalog med standard-SDK:er och insamlare i OpenTelemetry, utan att behöva anpassade bibliotek.

Information om hur du konfigurerar OTLP-klienten för att skicka data till Zerobus Ingest finns i Konfigurera OpenTelemetry-klienter (OTLP) för att skicka data till Unity Catalog.

Azure Databricks debiterar OTLP-inmatning som användning av Zerobus Ingest. För prissättning och hur du följer din konsumtion, se Kostnad.

Begrepp

Följande begrepp är användbara för att förstå hur Zerobus Ingest OTLP fungerar.

OTLP-kompatibilitet

Zerobus Ingest OTLP implementerar de standardiserade OTLP Collector-tjänsterna enligt OpenTelemetrie-specifikationen, både över gRPC och HTTP (Protobuf). Alla OTLP-kompatibla exportörer, såsom en OpenTelemetry SDK, OpenTelemetry Collector eller ett annat instrumenteringsbibliotek, kan skicka data till denna endpoint.

Signaler som stöds

Zerobus Ingest OTLP tillhandahåller en tjänst för varje typ av telemetrisignal. Varje signal är tillgänglig över både OTLP/gRPC och OTLP/HTTP (Protobuf):

Signal gRPC-tjänstsökväg HTTP-väg
Spårningar: Distribuerade spårningsintervall med fullt stöd för händelser, länkar och status. /opentelemetry.proto.collector.trace.v1.TraceService/Export /v1/traces
Loggar: Loggposter med allvarlighetsgrad, brödtext och korrelation till spår via trace_id och span_id. /opentelemetry.proto.collector.logs.v1.LogsService/Export /v1/logs
Mått: Alla fem OTLP-måtttyper: Gauge, Sum, Histogram, ExponentialHistogram och Summary. /opentelemetry.proto.collector.metrics.v1.MetricsService/Export /v1/metrics

Delvis lyckad

Zerobus Ingest OTLP stöder partiell framgång enligt definitionen i OTLP-specifikationen. Om en begäran innehåller en blandning av giltiga och ogiltiga poster matas de giltiga posterna in och ogiltiga poster avvisas. Svaret innehåller antalet avvisade poster (rejected_spans, , eller rejected_log_records) och en rejected_data_pointserror_messagebeskrivning av varför.

Komprimering

Gzip-komprimering stöds på alla tre OTLP-tjänster, både över gRPC och HTTP. För gRPC ställer du in rubriken grpc-encoding till gzip. För HTTP, ställ in Content-Encoding headern till gzip. Alternativt, konfigurera din OTLP-exportör att använda gzip-komprimering.

Begränsningar

  • Endast Protobuf-kodningen av OTLP/HTTP stöds. OTLP/HTTP med en JSON-kropp stöds inte, och förfrågningar med ett Content-Type of application/json avvisas.
  • Varje begäran riktar sig mot en tabell som anges av x-databricks-zerobus-table-name rubriken. Om du vill mata in spårningar, loggar och mått konfigurerar du separata exportörer som pekar på olika tabeller.
  • Tabeller måste skapas i förväg med rätt schema. Zerobus Ingest skapar eller ändrar inte tabeller.
  • Standardkvoten är 10 000 begäranden per sekund. Om du behöver en högre kvot kontaktar du din Databricks-representant.
  • Vissa OTLP-numeriska fält kan tappa precision eller överflöde när de mappas till Delta-typer. Se Numerisk precision och teckentyper.
  • För hela listan över Zerobus Ingest-kvoter, se Zerobus Ingest-kvoter.

Ytterligare resurser

  • Last updated on