Skip to main content

Latitude

还没翻译译自英文(ai-sdk.dev)本页 13 段都还没译

Latitude (GitHub) is an open-source MIT-licensed platform for AI agent observability with semantic trace search and issue tracking. It integrates with the AI SDK to capture:

  • Traces of every generateText, streamText, and tool call
  • Token usage and latency per call
  • Errors and failure patterns grouped as recurring issues

Setup

Latitude's SDK registers a global OpenTelemetry tracer. Once you register the AI SDK's telemetry integration, every AI SDK call emits spans automatically.

Install both packages:

pnpm add @latitude-data/telemetry @ai-sdk/otel
npm install @latitude-data/telemetry @ai-sdk/otel
yarn add @latitude-data/telemetry @ai-sdk/otel
bun add @latitude-data/telemetry @ai-sdk/otel

Sign in at app.latitude.so and grab your API key and project slug from the dashboard. Set them in your environment:

LATITUDE_API_KEY="..."
LATITUDE_PROJECT_SLUG="..."

Initialize Latitude and register telemetry once at startup. After that, every AI SDK call emits traces automatically:

import { Latitude } from '@latitude-data/telemetry';
import { registerTelemetry, generateText } from 'ai';
import { OpenTelemetry } from '@ai-sdk/otel';
import { openai } from '@ai-sdk/openai';

const latitude = new Latitude({
  apiKey: process.env.LATITUDE_API_KEY!,
  project: process.env.LATITUDE_PROJECT_SLUG!,
});

registerTelemetry(new OpenTelemetry());

const { text } = await generateText({
  model: openai('gpt-6-astra'),
  prompt: 'Hello',
});

await latitude.shutdown();

For named traces and per-call metadata (tags, user IDs, session IDs), wrap calls in Latitude's capture() helper:

import { capture } from '@latitude-data/telemetry';

await capture('generate-support-reply', async () => {
  const { text } = await generateText({
    model: openai('gpt-6-astra'),
    prompt: 'Hello',
  });
  return text;
});

Resources