Skip to main content

​
Installation

npm install @respan/exporter-vercel

​
Classes

​
RespanExporter

OpenTelemetry SpanExporter implementation that converts Vercel AI SDK spans to Respan format. 
import { RespanExporter } from '@respan/exporter-vercel';
ParameterTypeDefaultDescription
apiKeystring—Respan API key. Falls back to RESPAN_API_KEY env var.
baseUrlstring | undefined"https://api.respan.ai"API base URL.

​
Methods

MethodDescription
export(spans, resultCallback)Export OpenTelemetry spans to Respan.

​
Internal processing

The exporter automatically:
  • Deduplicates AI SDK spans
  • Parses model information, prompt messages, and tool calls
  • Extracts token usage and cost data
  • Maps Vercel AI metadata to Respan span attributes
  • Handles streaming response data

​
Usage

// instrumentation.ts
import { registerOTel } from '@vercel/otel';
import { RespanExporter } from '@respan/exporter-vercel';

export function register() {
  registerOTel({
    serviceName: 'my-app',
    traceExporter: new RespanExporter({
      apiKey: process.env.RESPAN_API_KEY!,
    }),
  });
}
Then enable telemetry in your AI SDK calls: 
import { generateText } from 'ai';
import { openai } from '@ai-sdk/openai';

const result = await generateText({
  model: openai('gpt-4o-mini'),
  prompt: 'Tell me a joke',
  experimental_telemetry: { isEnabled: true },
});