Source URL: https://docs.sentry.io/platforms/javascript/guides/nextjs/configuration/integrations/anthropic

Anthropic | Sentry for Next.js

Server-Side Usage

For meta-framework applications using all runtimes, you need to manually wrap your Anthropic client instance with instrumentAnthropicAiClient. See instructions in the Browser-Side Usage section.

Browser-Side Usage

Import name: Sentry.instrumentAnthropicAiClient

The instrumentAnthropicAiClient helper adds instrumentation for the @anthropic-ai/sdk API to capture spans by wrapping Anthropic SDK calls and recording LLM interactions with configurable input/output recording. You need to manually wrap your Anthropic client instance with this helper. See example below:

import Anthropic from "@anthropic-ai/sdk";

const anthropic = new Anthropic({
  apiKey: "your-api-key", // Warning: API key will be exposed in browser!
});

const client = Sentry.instrumentAnthropicAiClient(anthropic, {
  recordInputs: true,
  recordOutputs: true,
});

// Use the wrapped client instead of the original anthropic instance
const response = await client.messages.create({
  model: "claude-3-5-sonnet-20241022",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Hello!" }],
});

To customize what data is captured (such as inputs and outputs), see the Options in the Configuration section.

Configuration

Options

The following options control what data is captured from Anthropic SDK calls:

recordInputs

Type: boolean (optional)

Records inputs to Anthropic SDK calls (such as prompts and messages).

Defaults to true if sendDefaultPii is true.

recordOutputs

Type: boolean (optional)

Records outputs from Anthropic SDK calls (such as generated text and responses).

Defaults to true if sendDefaultPii is true.

Usage

Using the anthropicAIIntegration integration:

Sentry.init({
  dsn: "____PUBLIC_DSN____",
  // Tracing must be enabled for agent monitoring to work
  tracesSampleRate: 1.0,
  integrations: [
    Sentry.anthropicAIIntegration({
      // your options here
    }),
  ],
});

Using the instrumentAnthropicAiClient helper:

const client = Sentry.instrumentAnthropicAiClient(anthropic, {
  // your options here
});

Supported Operations

By default, tracing support is added to the following Anthropic SDK calls:

messages.create() - Create messages with Claude models
messages.stream() - Stream messages with Claude models
messages.countTokens() - Count tokens for messages
models.get() - Get model information
completions.create() - Create completions (legacy)
models.retrieve() - Retrieve model details
beta.messages.create() - Beta messages API

Streaming and non-streaming requests are automatically detected and handled appropriately.

Supported Versions

@anthropic-ai/sdk: >=0.19.2 <1.0.0