OpenTelemetry instrumentor for Strands AI agents.
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
Initialize the Strands Agent instrumentor.
Parameters
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
**kwargs – Additional instrumentation configuration (currently unused)
Example
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
**kwargs – Additional uninstrumentation configuration (currently unused)
Example
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
