Sessions

• Set a session ID at the trace level so all spans in a trace share it.
• Use the Sessions view in the Laminar UI to review all traces in the same session.

​

What is a Session?

​

Example

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

// One trace per turn/request; reuse the same sessionId across turns
export async function handleTurn(conversationId: string, userMessage: string) {
  return observe({ name: 'handleTurn', sessionId: conversationId }, async () => {
    // ... LLM calls / tools ...
  });
}

from lmnr import Laminar, observe

# One trace per turn/request; reuse the same session_id across turns.
# Note: set_trace_session_id must be called inside a span context (e.g., an @observe'd function).
@observe()
def handle_turn(conversation_id: str, user_message: str):
    Laminar.set_trace_session_id(conversation_id)
    # ... LLM calls / tools ...

​

Viewing Sessions in Laminar

1. Navigate to the Traces page
2. Select the Sessions tab
3. Click a session to expand and see all traces within it

​

Common Patterns

• Chatbots: session = conversation_id, trace = one user turn.
• Workflows: session = checkout-{userId}, trace = each step (validateCart, processPayment, createOrder).