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:
Newer release available (0.2.0)

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.1.3.tar.gz (12.9 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.1.3-py3-none-any.whl (14.3 kB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for respan_instrumentation_claude_agent_sdk-0.1.3.tar.gz
Algorithm Hash digest
SHA256 216923f4e7672c9d6fd5fcf1fa88889834bf2a66327bf36bb70f86d311bb6072
MD5 4275368da521eabf394fc036efe77010
BLAKE2b-256 b3c597c5e2352ab6a5b61b836a3d8443c7d0bf82e8146547ddedcbb210dd6ac7

See more details on using hashes here.

Provenance

The following attestation bundles were made for respan_instrumentation_claude_agent_sdk-0.1.3.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.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for respan_instrumentation_claude_agent_sdk-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 376fe9fb2bd3df69d24e1bd96cb0dde82cd627aea09572138609d1d446fb0d14
MD5 2053e0e0d3e1d1efc46089b3a35fe4c6
BLAKE2b-256 d4af973a86cc502fe51d5e3e9e4258ded3c6da4200c9558c56809f1a43778bb4

See more details on using hashes here.

Provenance

The following attestation bundles were made for respan_instrumentation_claude_agent_sdk-0.1.3-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.

Supported by

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