Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tracectrl.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Installation

Both packages are published to PyPI. 
pip install tracectrl tracectrl-instrumentation-agno

​
Usage

import tracectrl
from tracectrl import tag_agent
from tracectrl.instrumentation.agno import AgnoInstrumentor

tracectrl.configure(service_name="my-agno-agent")
AgnoInstrumentor().instrument()

from agno.agent import Agent

agent = Agent(model="gpt-4o", tools=[...])
tag_agent(agent)

agent.run("Analyze this document")
tag_agent(agent) stamps the agent’s identity onto subsequent spans so it shows up as a distinct node in TraceCtrl’s topology view.

​
What Gets Captured

Agno emits agent identity attributes natively. TraceCtrl’s span processor reads them and re-stamps them under the TraceCtrl schema:
Source attributeTraceCtrl attributeNotes
agno.agent.idtracectrl.agent.idPrimary agent identity
agno.team.idtracectrl.agent.idFallback when agno.agent.id is absent
agent.nametracectrl.agent.nameOpenInference-standard name attribute
session.idtracectrl.session_idFallback when no TraceCtrl session is active
tracectrl.agent.framework is set to agno whenever either agno.agent.id or agno.team.id is present on the span.

​
API

​
AgnoInstrumentor()

​
instrument
method
instrument(tracer_provider=None, skip_dep_check=False) — Registers the TraceCtrl span processor and wraps the OpenInference Agno instrumentor.
​
uninstrument
method
uninstrument() — Shuts down the TraceCtrl processor and unwraps the OpenInference instrumentor.
​
instrumented
bool
Whether the instrumentor is currently active.