Python · Instrumentation
openinference-instrumentation-claude-agent-sdk
OpenInference Claude Agent SDK Instrumentation
- Module
openinference.instrumentation.claude_agent_sdk- Version
- 0.1.29
- Python
- >=3.10, <3.16
- Instruments
claude-agent-sdk>=0.1.45
Install
pip install openinference-instrumentation-claude-agent-sdkUsage
Instrument once, at startup, before the library is used. The ClaudeAgentSDKInstrumentor reference below lists the options.
from opentelemetry.sdk.trace import TracerProvider
from openinference.instrumentation import TraceConfig
from openinference.instrumentation.claude_agent_sdk import ClaudeAgentSDKInstrumentor
tracer_provider = TracerProvider()
# ...add a span processor that exports to Phoenix or any OTLP backend.
ClaudeAgentSDKInstrumentor().instrument(
tracer_provider=tracer_provider,
config=TraceConfig(hide_inputs=True), # optional
)openinference.instrumentation.claude_agent_sdk
OpenInference instrumentation for the Claude Agent SDK (Python).
ClaudeAgentSDKInstrumentor
classSource ↗class ClaudeAgentSDKInstrumentor(BaseInstrumentor)An instrumentor for the Claude Agent SDK (query() and ClaudeSDKClient).
instrument
methoddef instrument(
*,
tracer_provider: Optional[TracerProvider] = None,
config: Optional[TraceConfig] = None,
skip_dep_check: bool = False,
) -> NoneStart tracing claude-agent-sdk: patch it so its calls make OpenInference spans. Calling it again does nothing. Inherited from OpenTelemetry’s BaseInstrumentor.
Parameters
| Name | Description |
|---|---|
tracer_provider | The tracer provider the spans are made with. Defaults to the global one, |
config | What the spans record: hide inputs, outputs or messages, or limit image sizes. Defaults to |
skip_dep_check | Instrument even if the installed version of |
uninstrument
methoddef uninstrument() -> NoneStop tracing: undo the patches instrument() made. Inherited from OpenTelemetry’s BaseInstrumentor.
instrumentation_dependencies
methodSource ↗def instrumentation_dependencies() -> Collection[str]