Tracing Structure

• Trace your own functions — Your agent has logic beyond LLM calls. Wrap functions with @observe to see them in traces.
• Add context — Attach user IDs, session IDs, metadata, and tags so you can filter and debug effectively.
• Control what’s captured — Skip recording inputs/outputs for sensitive operations.

​

Why Structure Matters

• Understand relationships between calls (routing → tool use → final answer)
• Follow multi-step workflows end-to-end
• Track conversations across turns
• Find the right trace quickly (by user/session/metadata)

​

Quickstart

import { Laminar, observe } from '@lmnr-ai/lmnr';

Laminar.initialize({
  projectApiKey: process.env.LMNR_PROJECT_API_KEY,
});

export async function handleRequest(userId: string, requestId: string) {
  return observe({ name: 'handleRequest' }, async () => {
    Laminar.setTraceUserId(userId);
    Laminar.setTraceSessionId(`session-${requestId}`);
    Laminar.setTraceMetadata({ environment: process.env.NODE_ENV });

    // ... your LLM calls / tools / business logic ...
  });
}

from lmnr import Laminar, observe
import os

Laminar.initialize()

@observe()
def handle_request(user_id: str, request_id: str):
    Laminar.set_trace_user_id(user_id)
    Laminar.set_trace_session_id(f"session-{request_id}")
    Laminar.set_trace_metadata({"environment": os.getenv("ENVIRONMENT")})

    # ... your LLM calls / tools / business logic ...

​

Quick Reference