Skip to main content

OpenInference Anthropic Instrumentation

Python autoinstrumentation library for the Anthropic package

This package implements the following Anthropic clients:

  • Messages (create, stream, parse, count_tokens)
  • AsyncMessages
  • Beta Messages and AsyncMessages, including those of the Bedrock and Vertex AI clients

llm.provider is the platform hosting the model: aws for Bedrock, google for Vertex AI, azure for Microsoft Foundry, and anthropic otherwise.

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
>=3.0.0 >=1.8.0 >=3.10, <3.15
>=2.1.6, <3.0.0 >=1.0.0 >=3.10, <3.15
2.1.5 >=1.0.0, <1.8 >=3.10, <3.15
>=2.0, <2.1.5 >=1.0.0, <1.5 >=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

Metadata

Release files for openinference-instrumentation-anthropic 3.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for openinference-instrumentation-anthropic 3.1.0
File Size Uploaded Provenance
openinference_instrumentation_anthropic-3.1.0.tar.gz 26.8 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for openinference-instrumentation-anthropic 3.1.0
File Interpreter ABI Platform
openinference_instrumentation_anthropic-3.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 58.3 kB

Release files / openinference_instrumentation_anthropic-3.1.0.tar.gz

Download URL openinference_instrumentation_anthropic-3.1.0.tar.gz
Size 26.8 kB
Tags Source
SHA-256 checksum
How to use checksums
8c40c9dfd1d965e9ca0c2b8c021c86da21491f26ac8ab002764fa5948426bfe8
BLAKE2b-256 checksum
How to use checksums
e1d252fb3fe4eb1ae11f03ee5228d3ce05c713ecd3d8cf0e15e3c2b8046b7817
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Release files / openinference_instrumentation_anthropic-3.1.0-py3-none-any.whl

Download URL openinference_instrumentation_anthropic-3.1.0-py3-none-any.whl
Size 31.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
be6cb36f30b38a8e3588c927ce609e98272746496352ae8f8c9c664b2f6dc37d
BLAKE2b-256 checksum
How to use checksums
82e5aff049d02cee0a0e999ab069274407d3264d52c3f73fc24e41300447c222
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

Security for openinference-instrumentation-anthropic 3.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for openinference_instrumentation_anthropic-3.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

3.1.0 This release

2 release files Full provenance

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