Skip to content

The cross-harness, self-improving memory layer for AI agents. Join our community: https://discord.com/invite/zdNChS2fBu

4.3 KB
Raw Blame
---
title: "Anthropic"
description: "Instrument Anthropic SDK calls with Beacon Observe"
---

## Integration overview

Use this integration when your application calls Anthropic's `@anthropic-ai/sdk` TypeScript package directly. Beacon Observe uses OpenLLMetry's Anthropic instrumentation so Anthropic model calls flow through the same exporter and Beacon-compatible attribute path as the rest of your agent telemetry.

## Overview

Initialize Beacon Observe before creating the Anthropic client when possible. The instrumentation captures supported Anthropic SDK spans without changing the way you call `anthropic.messages.create()`.

Using Claude Agent SDK instead of the direct provider SDK? See [Claude Agent SDK](/sdk/integrations-claude-agent-sdk).

## What Beacon captures

- Anthropic model calls emitted by the OpenLLMetry Anthropic instrumentation.
- OpenTelemetry resource attributes such as service name, SDK version, `beacon.origin=cloud`, and export mode.
- Beacon compatibility hints where supported by the SDK and instrumentation path.
- Errors recorded on failed spans.

## Prerequisites

- Node.js 20 or newer.
- `@asymptote/sdk` installed.
- `@anthropic-ai/sdk` installed.
- `ASYMPTOTE_API_KEY` set for Beacon Cloud hosted Observe, or `OTEL_EXPORTER_OTLP_ENDPOINT` set for customer-managed OTLP export. To get a Beacon Cloud API key, [reach out for a demo](https://asymptotelabs.ai/contact).

```bash title="Install the SDK and Anthropic client"
npm install @asymptote/sdk @anthropic-ai/sdk
```

Set environment variables:

```bash title="Set Beacon Cloud and Anthropic environment variables"
export ASYMPTOTE_API_KEY=...
export ANTHROPIC_API_KEY=...
```

## Getting started

Initialize `Observe` before creating the Anthropic client when possible.

```typescript title="Trace Anthropic messages.create" lines
import Anthropic from "@anthropic-ai/sdk";
import { Observe } from "@asymptote/sdk";

Observe.initialize({
  apiKey: process.env.ASYMPTOTE_API_KEY,
  instrumentationOptions: {
    anthropic: {
      traceContent: true,
    },
  },
});

const anthropic = new Anthropic({
  apiKey: process.env.ANTHROPIC_API_KEY,
});

const message = await anthropic.messages.create({
  model: "claude-sonnet-4-5",
  max_tokens: 1024,
  messages: [
    {
      role: "user",
      content: "Review this agent workflow for risky tool use.",
    },
  ],
});

await Observe.flush();
```

All supported Anthropic SDK calls are now traced through the configured Beacon exporter.

## Already-loaded clients

If your application imports or creates the Anthropic client before initialization, pass the module to `instrumentModules` or patch it after initialization.

```typescript title="Instrument an already-loaded Anthropic module" lines
import * as AnthropicSDK from "@anthropic-ai/sdk";
import { Observe } from "@asymptote/sdk";

const anthropic = new AnthropicSDK.Anthropic({
  apiKey: process.env.ANTHROPIC_API_KEY,
});

Observe.initialize({
  apiKey: process.env.ASYMPTOTE_API_KEY,
  instrumentModules: {
    Anthropic: AnthropicSDK,
  },
});
```

## Existing OpenTelemetry providers

If your application already owns OpenTelemetry setup, register only Beacon's Anthropic instrumentation with your existing provider.

```typescript title="Register Anthropic instrumentation on an existing provider" lines
import { registerInstrumentations } from "@opentelemetry/instrumentation";
import { Observe } from "@asymptote/sdk";

registerInstrumentations({
  instrumentations: Observe.instrumentations({
    openAI: false,
    anthropic: {
      traceContent: true,
    },
  }),
});
```

## Troubleshooting

- Confirm `ASYMPTOTE_API_KEY` or `OTEL_EXPORTER_OTLP_ENDPOINT` is set in the same process that runs the SDK.
- Initialize `Observe` before constructing the Anthropic client when possible.
- If the Anthropic module is imported before initialization, pass it through `instrumentModules` or `Observe.patch()`.
- Call `Observe.flush()` before short-lived scripts or jobs exit.

## What's next

<Columns cols={2}>
  <Card title="Claude Agent SDK" icon="robot" href="/sdk/integrations-claude-agent-sdk">
    Wrap Claude Agent SDK query functions with Beacon-compatible prompt spans.
  </Card>
  <Card title="Instrumentation" icon="wand-magic-sparkles" href="/sdk/instrumentation">
    Review initialization, module patching, and existing OpenTelemetry provider setup.
  </Card>
</Columns>