openinference

OpenInference Instrumentation for Claude Agent SDK

OpenTelemetry-based instrumentation for the Claude Agent SDK (@anthropic-ai/claude-agent-sdk). Produces AGENT and TOOL spans following OpenInference semantic conventions.

Installation

npm install @arizeai/openinference-instrumentation-claude-agent-sdk

Usage

Auto-instrumentation (CommonJS)

import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
import { ClaudeAgentSDKInstrumentation } from "@arizeai/openinference-instrumentation-claude-agent-sdk";

const provider = new NodeTracerProvider();
provider.register();

const instrumentation = new ClaudeAgentSDKInstrumentation();
instrumentation.setTracerProvider(provider);

Manual instrumentation (ESM)

import * as ClaudeAgentSDK from "@anthropic-ai/claude-agent-sdk";
import { ClaudeAgentSDKInstrumentation } from "@arizeai/openinference-instrumentation-claude-agent-sdk";

const instrumentation = new ClaudeAgentSDKInstrumentation({
  tracerProvider: provider,
});
instrumentation.manuallyInstrument(ClaudeAgentSDK);

With trace configuration (mask sensitive data)

const instrumentation = new ClaudeAgentSDKInstrumentation({
  tracerProvider: provider,
  traceConfig: {
    hideInputs: true,
    hideOutputs: true,
  },
});

Instrumented APIs

V1: query()

The query() function is wrapped to produce:

• An AGENT span for the entire query lifecycle
• TOOL child spans for each tool call (via hook injection)

V2 (unstable): unstable_v2_prompt(), unstable_v2_createSession(), unstable_v2_resumeSession()

• unstable_v2_prompt() produces an AGENT span
• Session methods produce per-turn AGENT spans with TOOL child spans

Span Attributes

AGENT spans

Attribute	Description
openinference.span.kind	"AGENT"
input.value	Prompt text
output.value	Result text
session.id	SDK session identifier
llm.model_name	Model used
llm.token_count.prompt	Input token count
llm.token_count.completion	Output token count
llm.token_count.total	Total token count
llm.cost.total	Total cost in USD

TOOL spans

Attribute	Description
openinference.span.kind	"TOOL"
tool.name	Tool name
tool.parameters	Tool input (JSON)
input.value	Tool input (JSON)
output.value	Tool response (JSON)

This site is open source. Improve this page.