traceloop-sdk
Traceloop Software Development Kit (SDK) for Python
What it is and what it does
Traceloop SDK is a Python instrumentation library that captures execution traces from LLM applications—calls to OpenAI, Anthropic, LangChain, LlamaIndex, and other frameworks—and exports them to Traceloop's cloud platform or to your own OpenTelemetry-compatible observability stack. It wraps your LLM code non-intrusively, meaning you initialize it once and then your existing application code generates traces automatically without modification.
The SDK includes built-in instrumentation for many LLM providers and frameworks (OpenAI, Anthropic, Bedrock, Cohere, Groq, LangChain, LlamaIndex, CrewAI, and others), plus vector databases and logging. You choose where traces go—Traceloop's managed service or your own observability backend via OTLP gRPC or HTTP exporters. It's designed for debugging, monitoring, and understanding LLM application behavior in development and production.
Use it for:
- Debug LLM application failures by inspecting full execution traces including all API calls and responses.
- Monitor token usage and latency across multiple LLM providers in a single dashboard.
- Export traces to an existing observability platform via OpenTelemetry OTLP exporters.
- Track performance of LangChain or LlamaIndex workflows across complex multi-step operations.
- Audit and log all interactions with external LLM APIs for compliance or cost analysis.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Traceloop SDK instruments LLM applications to capture execution traces and send them to Traceloop or your own observability backend, built on OpenTelemetry.
Yes, if you are building or operating LLM applications and need visibility into their behavior. The SDK is actively maintained, has no known vulnerabilities, and integrates seamlessly with popular frameworks. Install friction is low and the permissive license poses no barrier. Verify whether Traceloop's managed service fits your cost model and whether the instrumentation overhead is acceptable for your workload.
Install
traceloop-sdk on PyPI
pip
pip install traceloop-sdkuv
uv add traceloop-sdkpoetry
poetry add traceloop-sdkInstalling traceloop-sdk
Before you install
Low friction install as a pure Python wheel. Active maintenance with a recent release (4 days old) and strong community signal (7377 stars). 50 runtime dependencies, mostly OpenTelemetry instrumentation packages for specific LLM frameworks, means you pay the cost of what you actually use.
License in practice
Apache-2.0 permissive license allows commercial and private use with minimal restrictions.
Quickstart
pip install traceloop-sdk
from traceloop.sdk import Traceloop
Traceloop.init(app_name="my_app")
# Your LLM code is now traced
Requires Python 3.10 or later.
Verify before relying
- Whether traces sent to Traceloop incur costs or require a paid account.
- Performance overhead of tracing in production workloads.
- How to configure which LLM framework instrumentations are loaded selectively.
- Full list of supported LLM providers and frameworks beyond those in runtime dependencies.
Package facts
| License | Apache-2.0 (permissive) |
| Python support | supports the current Python release (<4,>=3.10) |
| Install friction | low — pure-Python wheel |
| Runtime dependencies | 50 — aiohttp, colorama, cuid, deprecated, jinja2, opentelemetry-api, opentelemetry-exporter-otlp-proto-grpc, opentelemetry-exporter-otlp-proto-http, opentelemetry-instrumentation-agno, opentelemetry-instrumentation-alephalpha, opentelemetry-instrumentation-anthropic, opentelemetry-instrumentation-bedrock, opentelemetry-instrumentation-chromadb, opentelemetry-instrumentation-cohere, opentelemetry-instrumentation-crewai, opentelemetry-instrumentation-google-generativeai, opentelemetry-instrumentation-groq, opentelemetry-instrumentation-haystack, opentelemetry-instrumentation-lancedb, opentelemetry-instrumentation-langchain, opentelemetry-instrumentation-litellm, opentelemetry-instrumentation-llamaindex, opentelemetry-instrumentation-logging, opentelemetry-instrumentation-marqo, opentelemetry-instrumentation-mcp, opentelemetry-instrumentation-milvus, opentelemetry-instrumentation-mistralai, opentelemetry-instrumentation-ollama, opentelemetry-instrumentation-openai, opentelemetry-instrumentation-openai-agents |
| Maintenance | actively maintained — 4 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 2,535,788/month — #3,016 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: traceloop_sdk-0.62.3-py3-none-any.whl
Tags
More Monitoring packages
Wraps any iterable to display a real-time…
copyleft · top 100 on PyPI
opentelemetry-semantic-conventionsProvides generated Python code for…
permissive · top 100 on PyPI
opentelemetry-sdkProvides the reference implementation of the…
permissive · top 100 on PyPI
opentelemetry-apiProvides the abstract API and interfaces for…
permissive · top 100 on PyPI
opentelemetry-exporter-otlp-proto-httpExports OpenTelemetry observability data to an…
permissive · top 1,000 on PyPI
opentelemetry-instrumentationProvides automatic instrumentation commands and…
permissive · top 1,000 on PyPI
lmnrPython SDK that traces, evaluates, and analyzes…
permissive · top 1,000 on PyPI
opentelemetry-instrumentation-openaiCaptures traces of OpenAI API calls (prompts,…
permissive · top 5,000 on PyPI
openinference-instrumentation-openaiAuto-instruments OpenAI Python SDK calls to…
permissive · top 5,000 on PyPI
opentelemetry-instrumentation-groqAutomatically captures traces of Groq SDK API…
permissive · top 5,000 on PyPI
opentelemetry-instrumentation-ollamaAdds distributed tracing to Ollama Python…
permissive · top 5,000 on PyPI
aliyun-traceManually creates traces for LLM applications…
permissive · top 5,000 on PyPI
opikOpik is an open-source LLM observability and…
permissive · top 5,000 on PyPI
opentelemetry-instrumentation-llamaindexAdds distributed tracing to LlamaIndex…
permissive · top 5,000 on PyPI
lumigo-tracerLumigo-tracer instruments Python Lambda…
permissive · top 15,000 on PyPI
langsmithLangSmith is a Python client SDK for the…
permissive · top 1,000 on PyPI