Pydantic AI Instrumentor

1 import { Respan } from "@respan/respan";
2 import { PydanticAIInstrumentor } from "@respan/instrumentation-pydantic-ai";
3 
4 const respan = new Respan({
5   instrumentations: [new PydanticAIInstrumentor()],
6 });
7 await respan.initialize();

Install

$ npm install @respan/respan @respan/instrumentation-pydantic-ai

This instrumentor wraps the active OpenTelemetry SpanProcessor and normalizes Pydantic AI-compatible spans before export. It supports:

Pydantic AI-native gen_ai.* span attributes (for example gen_ai.input.messages and gen_ai.output.messages).
Pydantic AI-scoped OpenInference spans (for example openinference.span.kind).

Configure

You can control which span sources are normalized in the constructor.

1 import { PydanticAIInstrumentor } from "@respan/instrumentation-pydantic-ai";
2 
3 const pydanticAIInstrumentor = new PydanticAIInstrumentor({
4   includeNativeSpans: true,
5   includeOpenInferenceSpans: true,
6 });

Example

1 import { Respan } from "@respan/respan";
2 import { PydanticAIInstrumentor } from "@respan/instrumentation-pydantic-ai";
3 import { trace } from "@opentelemetry/api";
4 
5 const respan = new Respan({
6   apiKey: process.env.RESPAN_API_KEY,
7   instrumentations: [new PydanticAIInstrumentor()],
8 });
9 await respan.initialize();
10 
11 const tracer = trace.getTracer("pydantic-ai-compatible");
12 const span = tracer.startSpan("chat completion", {
13   attributes: {
14     "gen_ai.operation.name": "chat",
15     "gen_ai.system": "openai",
16     "gen_ai.request.model": "gpt-4o-mini",
17   },
18 });
19 span.end();
20 
21 await respan.flush();