Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.lumiqtrace.com/llms.txt

Use this file to discover all available pages before exploring further.

LumiqTrace is an agent observability platform that helps you understand exactly what your AI agents are doing in production. Instrument your agents with two lines of code, then explore real-time traces, costs, tool call histories, and AI-powered insights in the LumiqTrace dashboard.

Quickstart

Instrument your first agent and see a trace in the dashboard in under 5 minutes.

Core concepts

Understand traces, spans, span kinds, projects, and the agent observability data model.

TypeScript SDK

Wrap OpenAI, Anthropic, Google, and other clients. Full agent tracing with withAgent.

Python SDK

Patch your Python LLM clients and use with_agent for multi-step agent tracing.

LangChain

Full chain, agent executor, and retriever tracing with LumiqtraceCallbackHandler.

Google ADK

Multi-agent tracing with instrumentADK, wrapADKRunner, or wrapADKAgent.

​
Get started in 3 steps

1

Create a project and get your API key

Sign up at app.lumiqtrace.com, create an organization, and create your first project. Your project API key (lqt_...) is shown once on creation — copy it now.
2

Install the SDK and instrument your agent

Install @lumiqtrace/sdk (Node.js) or lumiqtrace (Python), initialize with your API key, and wrap your existing clients or agent frameworks. No changes to your agent logic required.
import { lumiqtrace, withAgent } from "@lumiqtrace/sdk";
import OpenAI from "openai";

lumiqtrace.init({ apiKey: process.env.LUMIQTRACE_API_KEY!, environment: "production" });
const openai = lumiqtrace.wrapOpenAI(new OpenAI());
3

View your agent trace in the dashboard

Run your agent. Within seconds, the full trace appears in LumiqTrace with a flame graph showing every agent turn, tool call, and LLM interaction — with cost and latency for each step.
LumiqTrace adds zero latency to your agent runs. All telemetry is batched and flushed asynchronously — your agents are never blocked waiting for observability data to be sent.