Skip to main content

OpenInference Anthropic Instrumentation

Python autoinstrumentation library for the Anthropic package

This package implements the following Anthropic clients:

  • Messages
  • AsyncMessages
  • BetaMessagesParse
  • AsyncBetaMessagesParse

These traces are fully OpenTelemetry compatible and can be sent to an OpenTelemetry collector for viewing, such as Arize Phoenix or Arize AX.

Compatibility

openinference-instrumentation-anthropic anthropic Python
>=2.0 >=1.0.0 >=3.10, <3.15
>=1.0.1, <2.0 >=0.84.0, <1.0 >=3.10, <3.15
1.0.0 >=0.84.0, <1.0 >=3.9, <3.15

Anthropic 1.0 removed the legacy Text Completions API. Instrumentor 2.0 therefore requires anthropic>=1.0.0 and instruments the Messages and Beta Messages APIs. See Anthropic's v1 migration guide for the upstream breaking changes.

Installation

pip install openinference-instrumentation-anthropic

Quickstart

Through your terminal, install required packages.

pip install openinference-instrumentation-anthropic anthropic arize-phoenix opentelemetry-sdk opentelemetry-exporter-otlp

You can start Phoenix with the following terminal command:

python -m phoenix.server.main serve

By default, Phoenix listens on http://localhost:6006. You can visit the app via a browser at the same address. (Phoenix does not send data over the internet. It only operates locally on your machine.)

Try the following code in a Python file.

  1. Set up AnthropicInstrumentor to trace your application and sends the traces to Phoenix.
  2. Then, set your Anthropic API key as an environment variable.
  3. Lastly, create a Anthropic client, make a request, then go see your results in Phoenix at http://localhost:6006!
import os
from anthropic import Anthropic
from openinference.instrumentation.anthropic import AnthropicInstrumentor
from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter
from opentelemetry.sdk import trace as trace_sdk
from opentelemetry.sdk.trace.export import SimpleSpanProcessor

# Configure AnthropicInstrumentor with Phoenix endpoint
endpoint = "http://127.0.0.1:6006/v1/traces"
tracer_provider = trace_sdk.TracerProvider()
tracer_provider.add_span_processor(SimpleSpanProcessor(OTLPSpanExporter(endpoint)))

AnthropicInstrumentor().instrument(tracer_provider=tracer_provider)

os.environ["ANTHROPIC_API_KEY"] = "YOUR_KEY_HERE"

client = Anthropic()

response = client.messages.create(
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "Tell me about the history of Iceland!",
        }
    ],
    model="claude-3-opus-20240229",
)
print(response)

Now, on the Phoenix UI on your browser, you should see the traces from your Anthropic application. Click on a trace, then the "Attributes" tab will provide you with in-depth information regarding execution!

More Info

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

File details

Details for the file openinference_instrumentation_anthropic-2.1.1.tar.gz.

File metadata

File hashes

Hashes for openinference_instrumentation_anthropic-2.1.1.tar.gz
Algorithm Hash digest
SHA256 32f97e6395d11f16a57c6679e09548742378debfbb0d291b95901e36a2dfc2b8
MD5 e20c051466a67978410a2b432e0e4691
BLAKE2b-256 7067498cbf561402d32347fb4aeefe103fee65b93e2b7837af530e85f2c43a6b

See more details on using hashes here.

Provenance

The following attestation bundles were made for openinference_instrumentation_anthropic-2.1.1.tar.gz:

Publisher: publish.yaml on Arize-ai/openinference

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file openinference_instrumentation_anthropic-2.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for openinference_instrumentation_anthropic-2.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 854b57e1b848b4c6f5d261e0b7218870367718920761796c196e73d02770757a
MD5 1e58f529d0313a39d68cb6187483f70c
BLAKE2b-256 031acb1f1c53246ccc4ff564691c3c36e61b234d28d5423efba781c3721ac2e8

See more details on using hashes here.

Provenance

The following attestation bundles were made for openinference_instrumentation_anthropic-2.1.1-py3-none-any.whl:

Publisher: publish.yaml on Arize-ai/openinference

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

2.1.5

2 files

2.1.4

2 files

2.1.3

2 files

2.1.2

2 files

This release

2.1.1 This release

2 files

2.1.0

2 files

2.0.1

2 files

2.0.0

2 files

1.1.2

2 files

1.1.1

2 files

1.1.0

2 files

1.0.6

2 files

1.0.5

2 files

1.0.4

2 files

1.0.3

2 files

1.0.2

2 files

1.0.1

2 files

1.0.0

2 files

0.1.20

2 files

0.1.19

2 files

0.1.18

2 files

0.1.17

2 files

0.1.16

2 files

0.1.15

2 files

0.1.14

2 files

0.1.13

2 files

0.1.12

2 files

0.1.11

2 files

0.1.10

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page