Using a Supported Framework

1. Install @uselemma/tracing (TypeScript) or uselemma-tracing (Python)
2. Register the Lemma tracer provider at startup
3. Wrap your top-level agent function with agent() to create a run boundary

​

Setup

​

Install

npm install @uselemma/tracing

pip install uselemma-tracing

​

Register the tracer provider

// instrumentation.ts
export async function register() {
  if (process.env.NEXT_RUNTIME === "nodejs") {
    const { registerOTel } = await import("@uselemma/tracing");
    registerOTel();
  }
}

// tracer.ts — import this first in your entry point
import { registerOTel } from "@uselemma/tracing";
registerOTel();

// index.ts
import "./tracer"; // must be first

from uselemma_tracing import register_otel
register_otel()

​

Pick your framework

​

Common patterns

• Custom span attributes — attach user ID, session, and environment metadata to run spans
• Multi-turn threads — link related runs into a conversation thread

​

Next Steps

• Troubleshooting — spans not appearing or not nesting correctly
• Adding provider instrumentation — if you also call provider SDKs directly (not through a framework)