Respan Braintrust Instrumentation
Send Braintrust spans to Respan through the current Respan OTLP tracing pipeline.
Installation
pip install respan-ai respan-instrumentation-braintrust braintrust
Quick Start
import braintrust
from respan import Respan
from respan_instrumentation_braintrust import BraintrustInstrumentor
respan = Respan(instrumentations=[BraintrustInstrumentor()])
logger = braintrust.init_logger(
project="braintrust-demo",
async_flush=False,
)
with respan.propagate_attributes(group_identifier="Braintrust Demo"):
with logger.start_span(name="Braintrust Demo", type="task") as root:
with root.start_span(name="answer_question", type="llm") as span:
span.log(
input=[{"role": "user", "content": "What is Respan?"}],
output="Respan captures production LLM traces.",
metadata={"model": "gpt-4o-mini"},
metrics={"prompt_tokens": 8, "completion_tokens": 9},
)
logger.flush()
respan.flush()
respan.shutdown()
How It Works
BraintrustInstrumentor installs itself as Braintrust's background logger.
When Braintrust flushes, the instrumentor translates Braintrust records into
canonical Respan/OpenTelemetry spans and injects them into the same pipeline used
by respan-tracing.
The instrumentation maps Braintrust span types as follows:
llmandchat->chattoolandfunction->toolevalandautomation->workflowtask,score,facet, andpreprocessor->task
Braintrust-specific record fields are stored as metadata, while shared Respan
and GenAI span fields use constants from respan-sdk and upstream semantic
convention packages.
Metadata
Release files for respan-instrumentation-braintrust 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| respan_instrumentation_braintrust-0.1.1.tar.gz | 7.1 kB | Without provenance | Details for respan_instrumentation_braintrust-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| respan_instrumentation_braintrust-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for respan_instrumentation_braintrust-0.1.1-py3-none-any.whl |
Total release size: 15.8 kB
Release files / respan_instrumentation_braintrust-0.1.1.tar.gz
| Download URL | respan_instrumentation_braintrust-0.1.1.tar.gz |
|---|---|
| Size | 7.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
addd09e7d4d4c18223cd54f9d938c260eb21ad399d6a7ed1ed7885bf7d9787e7
|
|
BLAKE2b-256 checksum How to use checksums |
7663962b0401fc35e50227e0acda3338cec2a3464c310b282da92151d783ef11
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.6
|
Release files / respan_instrumentation_braintrust-0.1.1-py3-none-any.whl
| Download URL | respan_instrumentation_braintrust-0.1.1-py3-none-any.whl |
|---|---|
| Size | 8.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b3edd366f7b6e7f508fd4e27dbd6fa8bb672b612c64b229a106a1fb18db32573
|
|
BLAKE2b-256 checksum How to use checksums |
bafcca49dc8a63b660db9256e49ae75da68922e9a897e22010d7de2cc2b3a965
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.6
|
Security for respan-instrumentation-braintrust 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.