How To Use Tracing

Tracing helps you understand how agents behave in production and creates the data foundation for optimization and model improvement.

Python

Install:

pip install overmind openai

Initialize once at startup:

from overmind import init

init(
    service_name="my-service",
    environment="production",
    providers=["openai"],
)

After init(), your provider calls are traced automatically.

JavaScript / TypeScript

Install:

npm install @overmind-lab/trace-sdk openai

Initialize tracing:

import { OpenAI } from "openai";
import { OvermindClient } from "@overmind-lab/trace-sdk";

const overmindClient = new OvermindClient({
  apiKey: process.env.OVERMIND_API_KEY!,
  appName: "my-app",
});

overmindClient.initTracing({
  enableBatching: true,
  enabledProviders: { openai: OpenAI },
});

Best practices

• set service_name/appName clearly per service
• tag traces with user/workflow metadata
• run tracing in staging first, then production
• keep tracing enabled continuously for better improvement signals

Next

• SDK Reference - Python
• SDK Reference - Javascript
• Integrations