OpenTelemetry-gegevens opnemen met Zerobus Ingest

Belangrijk

Deze functie bevindt zich in de bètaversie.

Zerobus Ingest OTLP is een systeemeigen OTLP-eindpunt (OpenTelemetry Protocol) dat is ingebouwd in de Zerobus Ingest-service . Hiermee kunt u traceringen, logboeken en metrische gegevens rechtstreeks naar Unity Catalog Delta-tabellen pushen met behulp van standaard Sdk's voor OpenTelemetry en collectors, zonder dat u aangepaste bibliotheken nodig hebt.

Als u uw OTLP-client wilt configureren voor het verzenden van gegevens naar Zerobus Ingest, raadpleegt u OpenTelemetry-clients (OTLP) configureren om gegevens naar Unity Catalog te verzenden.

Concepten

De volgende concepten zijn handig om te begrijpen hoe Zerobus Ingest OTLP werkt.

OTLP-compatibiliteit

Zerobus Ingest OTLP implementeert de standaard OTLP gRPC Collector-services zoals gedefinieerd door de OpenTelemetry-specificatie. Elke OTLP-compatibele exporteur (zoals OpenTelemetry SDK's, de OpenTelemetry Collector of andere instrumentatiebibliotheken) kan gegevens naar dit eindpunt verzenden.

Ondersteunde signalen

Zerobus Ingest OTLP maakt drie OTLP-/gRPC-services beschikbaar, één per telemetriesignaaltype :

Signaal gRPC-servicepad
Traces: Gedistribueerde tracesegmenten met volledige ondersteuning voor gebeurtenissen, koppelingen en status. /opentelemetry.proto.collector.trace.v1.TraceService/Export
Logboeken: Logboekrecords met ernst, hoofdtekst en correlatie naar traceringen via trace_id en span_id. /opentelemetry.proto.collector.logs.v1.LogsService/Export
Metrische gegevens: Alle vijf metrische OTLP-typen: Meter, Som, Histogram, ExponentieelHistogram en Samenvatting. /opentelemetry.proto.collector.metrics.v1.MetricsService/Export

Gedeeltelijk succes

Zerobus Ingest OTLP ondersteunt gedeeltelijk succes zoals gedefinieerd door de OTLP-specificatie. Als een aanvraag een combinatie van geldige en ongeldige records bevat, worden de geldige records opgenomen en worden de ongeldige records geweigerd. Het antwoord bevat het aantal geweigerde records (rejected_spans, rejected_log_recordsof rejected_data_points) en een error_message beschrijving waarom.

Compressie

Gzip-compressie wordt ondersteund op alle drie de OTLP-services. Stel de grpc-encoding header in op gzipof configureer uw OTLP-exporteur om gzip-compressie te gebruiken.

Beperkingen

  • Alleen de OTLP/gRPC-verbinding (Protobuf) wordt ondersteund. HTTP (Protobuf) wordt nog niet ondersteund.
  • Elke aanvraag is gericht op één tabel, die is opgegeven met behulp van de x-databricks-zerobus-table-name header. Als u traceringen, logboeken en metrische gegevens wilt opnemen, configureert u afzonderlijke exporteurs die naar verschillende tabellen verwijzen.
  • Tabellen moeten vooraf worden gemaakt met het juiste schema. Zerobus Ingest maakt of wijzigt geen tabellen.
  • Het standaardquotum is 10.000 aanvragen per seconde. Als u een hoger quotum nodig hebt, neemt u contact op met uw Databricks-vertegenwoordiger.
  • Zie Zerobus Ingest connectorbeperkingen voor een volledige lijst met beperkingen voor Zerobus Ingest.

Volgende stappen 

  • Last updated on