​
Overview

Effective trace structuring enhances the value of your tracing data, making it easier to debug, analyze, and optimize your LLM applications. This section covers the essential components of trace structuring in Laminar:
ComponentDescription
ObserveCreate a span with observe function decorator or wrapper
Manual span creationCreate a span manually within a function
SessionsGroup related traces together for better organization
User IDAssociate traces with specific users for targeted analysis
MetadataAdd contextual information to your traces for filtering and grouping

​
Why Structure Matters

Without structure, each LLM call creates an isolated trace, making it difficult to:
  • Understand the relationships between different LLM calls
  • Track user journeys through your application
  • Debug complex multi-step workflows
  • Find relevant traces quickly
Properly structured traces provide a clear picture of your application’s flow, making it easier to identify bottlenecks, debug issues, and optimize performance.

​
Quickstart

Start by implementing the observe wrapper or decorator to create parent spans that group your LLM calls into meaningful traces. Then, enhance these traces with session id, user id, and metadata to create a comprehensive tracing structure. 
// Example: A well-structured trace implementation
import { Laminar, observe } from '@lmnr-ai/lmnr';

// Initialize with your project key
Laminar.initialize({
  projectApiKey: process.env.LMNR_PROJECT_API_KEY,
});

// Create a parent span for the entire request
await observe({ name: 'processUserRequest' }, async (userId, requestId) => {
  // Your LLM calls and other operations will be children 
  // of this 'processUserRequest' span
  // and inherit the session id, user id, and metadata

  Laminar.setTraceUserId(userId);

  Laminar.setTraceSessionId(`session-${requestId}`);

  Laminar.setTraceMetadata({
    environment: process.env.NODE_ENV
  });

  // ... you LLM calls here ...
});
Explore each component in detail through the links above to implement a comprehensive tracing structure for your LLM applications.