respan-instrumentation-claude-agent-sdk

Respan instrumentation plugin for the Claude Agent SDK.

This package enables the Claude Agent SDK's native OpenTelemetry emission and normalizes those spans into the Respan/Traceloop conventions used by the OTLP pipeline.

Configuration

1. Install

pip install respan-instrumentation-claude-agent-sdk

2. Set Environment Variables

Variable Required Description
RESPAN_API_KEY Yes Your Respan API key. Authenticates both proxy and tracing.
RESPAN_BASE_URL No Defaults to https://api.respan.ai/api.

All vendor-specific variables (for example ANTHROPIC_API_KEY) are derived from these in your application code.

Quickstart

3. Run Script

import asyncio
import os

import claude_agent_sdk
from claude_agent_sdk import ClaudeAgentOptions, ResultMessage
from respan import Respan
from respan_instrumentation_claude_agent_sdk import ClaudeAgentSDKInstrumentor

respan_api_key = os.environ["RESPAN_API_KEY"]
respan_base_url = os.getenv("RESPAN_BASE_URL", "https://api.respan.ai/api")

os.environ["ANTHROPIC_API_KEY"] = respan_api_key
os.environ["ANTHROPIC_AUTH_TOKEN"] = respan_api_key
os.environ["ANTHROPIC_BASE_URL"] = f"{respan_base_url}/anthropic"

respan = Respan(
    api_key=respan_api_key,
    base_url=respan_base_url,
    instrumentations=[ClaudeAgentSDKInstrumentor(capture_content=True)],
)


async def main() -> None:
    options = ClaudeAgentOptions(
        model="sonnet",
        max_turns=1,
        permission_mode="bypassPermissions",
        cwd=os.getcwd(),
        env={
            "ANTHROPIC_API_KEY": respan_api_key,
            "ANTHROPIC_AUTH_TOKEN": respan_api_key,
            "ANTHROPIC_BASE_URL": f"{respan_base_url}/anthropic",
        },
    )

    async for message in claude_agent_sdk.query(
        prompt="Reply with exactly hello_from_claude_sdk.",
        options=options,
    ):
        if isinstance(message, ResultMessage):
            print(message.result)


asyncio.run(main())
respan.flush()

4. View Dashboard

After running the script, traces appear on your Respan dashboard.

Further Reading

See the python/tracing/claude-agent-sdk example for a runnable end-to-end workflow that covers tool use, multi-turn sessions, and edge cases.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for fran3cc from gravatar.com fran3cc

Credits

Author: Respan

License

Other/Proprietary License (Apache 2.0)

Requires

Python <3.14, >=3.11

Classifiers

Report project as malware

Download files

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

Source Distribution

respan_instrumentation_claude_agent_sdk-0.2.1.tar.gz (13.4 kB view details)

Uploaded Source

Built Distribution

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

respan_instrumentation_claude_agent_sdk-0.2.1-py3-none-any.whl (14.7 kB view details)

Uploaded Python 3

File details

Details for the file respan_instrumentation_claude_agent_sdk-0.2.1.tar.gz.

File metadata

File hashes

Hashes for respan_instrumentation_claude_agent_sdk-0.2.1.tar.gz
Algorithm Hash digest
SHA256 9e1ed97cf5047a522a1281b08608f4efffc17680c1c49d0443c7a0c04f607f37
MD5 6ec3aeed268b94f6ff2ac511f63f2553
BLAKE2b-256 be6cc92e69aa6abb007e5a5922059cca9ca72308356254f2710e23c2b0537ff4

See more details on using hashes here.

Provenance

The following attestation bundles were made for respan_instrumentation_claude_agent_sdk-0.2.1.tar.gz:

Publisher: publish.yml on respanai/respan

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

File details

Details for the file respan_instrumentation_claude_agent_sdk-0.2.1-py3-none-any.whl.

File metadata

File hashes

Hashes for respan_instrumentation_claude_agent_sdk-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 95e277334767f5c0d51141b1f815bb1e0290d1425673e05e0c4df8e006f7bfa5
MD5 86146aa75b7b237a390535bd61e683b9
BLAKE2b-256 bd7e3203ac6e495f56bf9976a28703710ad2b42d747c2570c2777b414f776105

See more details on using hashes here.

Provenance

The following attestation bundles were made for respan_instrumentation_claude_agent_sdk-0.2.1-py3-none-any.whl:

Publisher: publish.yml on respanai/respan

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

Release history Release notifications | RSS feed

This release

0.2.1 This release

2 files

0.2.0

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page