StrandsAgentInstrumentor

This instrumentor automatically injects FiddlerInstrumentationHook into all Strands Agent instances, enabling automatic observability without manual hook configuration. It also registers a StrandsSpanProcessor for attribute denormalization. The instrumentor follows the OpenTelemetry instrumentation pattern and can be enabled/disabled dynamically.

Example

from strands.telemetry import StrandsTelemetry
from fiddler_strandsagents import StrandsAgentInstrumentor

telemetry = StrandsTelemetry()
telemetry.setup_otlp_exporter()

# Enable instrumentation
instrumentor = StrandsAgentInstrumentor(telemetry)
instrumentor.instrument()

# Create agents - hooks are automatically injected
agent = Agent(model=model, system_prompt="...")

Initialize the Strands Agent instrumentor.

Parameters

StrandsTelemetry

required

StrandsTelemetry instance for configuring trace exporters

instrumentation_dependencies()

Return the list of packages required for instrumentation.

Returns

Collection of package names with version constraints

instrument()

Enable automatic instrumentation of Strands agents. Activates the instrumentor by registering the StrandsSpanProcessor with the tracer provider and patching Agent.init to automatically inject FiddlerInstrumentationHook into all agent instances. This method is idempotent - calling it multiple times has the same effect as calling it once. After activation, all newly created agents will automatically include Fiddler’s instrumentation hook.

Parameters

Any

Additional instrumentation configuration (currently unused)

Example

from strands import Agent
from strands.telemetry import StrandsTelemetry
from fiddler_strandsagents import StrandsAgentInstrumentor

# Set up telemetry
telemetry = StrandsTelemetry()
telemetry.setup_otlp_exporter()

# Activate instrumentation
instrumentor = StrandsAgentInstrumentor(telemetry)
instrumentor.instrument()

# Agents created after this point are automatically instrumented
agent = Agent(model=model, system_prompt="...")

# Check if instrumentation is active
if instrumentor.is_instrumented_by_opentelemetry:
    print("Instrumentation is active")

uninstrument()

Disable automatic instrumentation and restore original behavior. Deactivates the instrumentor by restoring the original Agent.init method. Agents created after calling this method will no longer have FiddlerInstrumentationHook automatically injected. Note: This does not affect agents that were already created while instrumentation was active - those will retain their hooks.

Parameters

Any

Additional uninstrumentation configuration (currently unused)

Example

from fiddler_strandsagents import StrandsAgentInstrumentor

instrumentor = StrandsAgentInstrumentor(telemetry)
instrumentor.instrument()

# Create some agents (automatically instrumented)
agent1 = Agent(model=model, system_prompt="...")

# Deactivate instrumentation
instrumentor.uninstrument()

# New agents won't be instrumented
agent2 = Agent(model=model, system_prompt="...")

# agent1 still has the hook, agent2 does not

property is_instrumented_by_opentelemetry

Check whether instrumentation is currently active.

Returns

True if the instrumentor has been activated via instrument() and not yet deactivated via uninstrument(), False otherwise

Example

instrumentor = StrandsAgentInstrumentor(telemetry)
print(instrumentor.is_instrumented_by_opentelemetry)  # False

instrumentor.instrument()
print(instrumentor.is_instrumented_by_opentelemetry)  # True

instrumentor.uninstrument()
print(instrumentor.is_instrumented_by_opentelemetry)  # False

Fiddler Python Client SDK

Fiddler Evals SDK

Fiddler OTel SDK

Fiddler LangGraph SDK

Fiddler LangChain SDK

Fiddler Google ADK SDK

Fiddler Strands Agent SDK

Fiddler OTel JS SDK

Fiddler LangGraph JS SDK

Fiddler LangChain JS SDK

Example

Parameters

instrumentation_dependencies()

Returns

instrument()

Parameters

Example

uninstrument()

Parameters

Example

property is_instrumented_by_opentelemetry

Returns

Example

​Example

​Parameters

​instrumentation_dependencies()

​Returns

​instrument()

​Parameters

​Example

​uninstrument()

​Parameters

​Example

​property is_instrumented_by_opentelemetry

​Returns

​Example

Example

Parameters

instrumentation_dependencies()

Returns

instrument()

Parameters

Example

uninstrument()

Parameters

Example

property is_instrumented_by_opentelemetry

Returns

Example