Traceloop

Setup

This integration uses Braintrust’s Python SDK OpenTelemetry configuration. Install Traceloop alongside the Braintrust SDK, then point it at Braintrust’s OpenTelemetry endpoint.

Install the packages

Install Traceloop with the Braintrust SDK’s OpenTelemetry support and the OpenAI client:

pip install "braintrust[otel]" traceloop-sdk openai

Configure environment variables

Point Traceloop at Braintrust by setting its base URL and headers:

.env

TRACELOOP_BASE_URL=https://api.braintrust.dev/otel
TRACELOOP_HEADERS="Authorization=Bearer%20<Your API Key>, x-bt-parent=project_id:<Your Project ID>"

When setting the bearer token, encode the space between “Bearer” and your API key using %20.

OpenTelemetry

To send traces to Braintrust, initialize Traceloop. It exports spans to the project named in the x-bt-parent header:

traceloop_braintrust.py

from openai import OpenAI
from traceloop.sdk import Traceloop
from traceloop.sdk.decorators import workflow

Traceloop.init(disable_batch=True)
client = OpenAI()

@workflow(name="story")
def run_story(client):
    response = client.responses.create(
        model="gpt-5-mini",
        input=[{"role": "user", "content": "Tell me a short story about LLM evals."}],
    )
    return response.output_text

print(run_story(client))

AI providers

SDKs

Developer tools

Runtime environments

Setup

OpenTelemetry

Resources

​Setup

​OpenTelemetry

​Resources

Setup

OpenTelemetry

Resources