SDK Log Ingestion

Use the Python SDK to upload OTLP trace data in batch

Distributional is now Talaria Scientific. The DBNL product described in these docs has been sunset; this documentation is preserved for reference. Read the announcement.

Push OTLP trace data manually or as part of a daily orchestration job using our Python SDK. This ingestion method is ideal for backfilling historical trace data or integrating into batch pipelines where you already have collected OTLP traces.

See the Python SDK docs for more detailed information about SDK installation and functions.

For real-time trace ingestion directly from your application, see OTEL Trace Ingestion instead.

Overview

The dbnl.log() function accepts a Pandas Series of OTLP TracesData (proto bytes or JSON) and uploads it to a project for a given date range. Each element in the Series should be a single TracesData message containing resourceSpans, the same top-level structure produced by OpenTelemetry SDKs and the OTLP exporter.

Traces must adhere to the DBNL Semantic Convention for the richest analysis. If you are using OpenInference instrumentation, the required fields (input, output, timestamp) are automatically mapped from span attributes.

Example Code

Check out the Quickstart for an end-to-end example of using SDK Log Ingestion.

DBNL-quickstart.ipynb

5KB

Open