traceloop-sdk

import os # CRITICAL: Import and init Traceloop BEFORE importing openai, langchain, etc. # The SDK patches provider modules at init time — late import means no instrumentation. from traceloop.sdk import Traceloop from traceloop.sdk.decorators import workflow, task # Option A: Export to Traceloop cloud Traceloop.init( app_name='my-llm-app', api_key=os.environ['TRACELOOP_API_KEY'], disable_batch=True # disable in dev — sends spans immediately, not in batches ) # Option B: Export to any OTLP backend (no Traceloop account needed) # Set via env vars before init: # TRACELOOP_BASE_URL=http://localhost:4318 (Jaeger, Grafana Agent, etc.) # TRACELOOP_HEADERS='Authorization=Bearer <token>' Traceloop.init(app_name='my-llm-app') # reads env vars automatically # Provider imports AFTER init import openai client = openai.OpenAI() # Manual tracing with decorators @workflow(name='answer_question') def answer_question(question: str) -> str: response = client.chat.completions.create( model='gpt-4o', messages=[{'role': 'user', 'content': question}] ) return response.choices[0].message.content # @task for sub-steps within a workflow @task(name='format_prompt') def format_prompt(question: str) -> str: return f'Answer concisely: {question}' result = answer_question('What is OpenTelemetry?')