Skip to main content

​
Installation

Both packages are published to PyPI.

​
Usage

tag_agent(agent) stamps the agent’s identity onto subsequent spans so the agent surfaces correctly in TraceCtrl’s topology and session views.

​
Implementation Note

Unlike the other instrumentors (which wrap an OpenInference Instrumentor class), the Strands integration uses StrandsAgentsToOpenInferenceProcessor — a processor-based pattern. The StrandsInstrumentor wrapper provides the same .instrument() / .uninstrument() API for consistency.

​
What Gets Captured

  • Agent execution spans with model information
  • Tool calls with risk category classification
  • Input/output values
  • Session correlation via tracectrl.session_id

​
API

​
StrandsInstrumentor()

​
method
instrument(tracer_provider=None, **kwargs) — Registers the TraceCtrl span processor and the Strands-to-OpenInference processor. Only tracer_provider is consumed; extra kwargs are accepted but ignored.
​
method
uninstrument() — Shuts down the TraceCtrl processor. The underlying Strands processor cannot be removed from the tracer provider.
​
bool
Whether the instrumentor is currently active.