Skip to main content
PyPI

Overview

Complete API reference documentation for the fiddler-strands package, which instruments the Strands Agents SDK and exports OpenTelemetry traces to Fiddler. The package is published to PyPI as fiddler-strands and imported in Python as fiddler_strandsagents:
pip install fiddler-strands
from fiddler_strandsagents import StrandsAgentInstrumentor

Components

Conversation And Session

Conversation and session attribute helpers. set_conversation_id / get_conversation_id set and read the conversation ID for the current execution context. set_session_attributes / get_session_attributes replace and read the session attribute dict for the current context.

Instrumentation

StrandsAgentInstrumentor installs Fiddler tracing into the Strands Agents runtime. FiddlerInstrumentationHook is the Strands hook used internally by the instrumentor.

Llm Context

set_llm_context attaches context (e.g. retrieved documents) to a Strands Model so it appears on its LLM spans. clear_llm_context removes previously set LLM context. get_llm_context reads the current LLM context for a model.

Span Attributes

set_span_attributes and get_span_attributes set and read per-span custom attributes.

Span Processor

StrandsSpanProcessor propagates parent attributes and patches Strands’ missing gen_ai.system.message event. FiddlerSpanProcessor is a backwards-compatible alias for StrandsSpanProcessor (same class object).