If you only need request routing through the Catalyst gateway, start with
model provider integrations. If you need trace trees
for agents, tools, framework runs, or non-gateway work, use the tracing SDKs.
Getting Started
Using a coding agent? Paste this into your agent to set up Catalyst trace collection:- Quickstart - install a tracing SDK, configure export, and capture your first provider span.
- Provider and framework guides - instrument OpenAI, Anthropic, LangChain, LangGraph, LangSmith, OpenAI Agents, Claude Agent SDK, Claude Code, Pydantic AI, and other supported surfaces.
- Manual spans - wrap custom agents, subprocesses, tools, retrieval, routing, and unsupported SDKs yourself.
Supported Trace Integrations
OpenAI
Trace Chat Completions, tool calls, structured outputs, and Responses API
calls.
Anthropic
Trace Messages API calls, tool use round trips, and prompt-cache usage.
LangChain
Capture chains, agents, model calls, and tools through callback
instrumentation.
LangGraph
Capture graph and node spans while preserving parent-child relationships.
LangSmith
Bridge LangSmith OpenTelemetry spans into Catalyst.
OpenAI Agents
Trace agent runs, tools, handoffs, and nested OpenAI model calls.
Claude Agent SDK
Trace Claude Agent SDK query loops and yielded messages.
Claude Code SDK
Trace Claude Code CLI subprocess calls and SDK-style agent invocations.
Manual spans
Wrap custom agents, CLI calls, provider routing, and unsupported SDKs.
Packages
| Runtime | Package | Primary import |
|---|---|---|
| TypeScript / Node / Bun | @inference/tracing | import { setup } from "@inference/tracing" |
| Python | inference-catalyst-tracing | from inference_catalyst_tracing import setup |
What Gets Captured
| Span data | Examples |
|---|---|
| Inputs and outputs | input.value, output.value |
| Messages | user, system, assistant, tool, and tool-result messages |
| Tool calls | tool names, IDs, JSON arguments, and tool results |
| Model metadata | model name, provider/system, invocation parameters |
| Usage | prompt, completion, total, and prompt-cache token counts when available |
| Agent structure | agent spans, framework spans, tool spans, graph/node spans |
| Errors | exception status and error details on failed spans |
How It Works
setup()configures a Catalyst OpenTelemetry exporter.- The SDK instruments the providers or frameworks you enable.
- Your app runs normally.
- Spans are exported to Catalyst and grouped by service, trace, span, and task metadata.
Next Steps
Quickstart
Install an SDK, configure export, and capture your first model span.
Instrumentation examples
Browse copyable examples for tools, agents, framework runs, and manual spans.
Troubleshooting
Debug missing spans, missing attributes, and shutdown behavior.