Skip to main content
Agno traces can include prompts, completions, tool inputs, and tool outputs. Review Data Governance before enabling production traffic.

​
Install

pip install agno openinference-instrumentation-agno \
            opentelemetry-sdk opentelemetry-exporter-otlp-proto-http

​
Setup

import os
from agno.agent import Agent
from agno.models.openai import OpenAIChat
from openinference.instrumentation.agno import AgnoInstrumentor
from openinference.instrumentation import using_attributes
from opentelemetry import trace
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import BatchSpanProcessor
from opentelemetry.exporter.otlp.proto.http.trace_exporter import OTLPSpanExporter

os.environ["OTEL_EXPORTER_OTLP_ENDPOINT"] = "https://otel.agnost.ai"
os.environ["OTEL_EXPORTER_OTLP_HEADERS"] = "X-Agnost-Org-ID=<your-org-id>"

provider = TracerProvider()
provider.add_span_processor(BatchSpanProcessor(OTLPSpanExporter()))
trace.set_tracer_provider(provider)
AgnoInstrumentor().instrument()

agent = Agent(
    model=OpenAIChat(id="gpt-4o-mini"),
    session_id="sess-123",   # Agno's first-class session
    user_id="u-42",
)

with using_attributes(session_id="sess-123", user_id="u-42"):
    agent.print_response("Hello")
Agno itself supports session_id and user_id as Agent constructor params. Spans carry OpenInference attributes plus agno.agent.name / agno.team.name. Instrument once at process start; child agents in teams inherit.

​
Alternative: OpenLit

openlit.init(...) is also supported and auto-instruments common providers in one shot.

​
Verify

Run one agent.print_response call, then open Raw logs in Agnost. Confirm spans include session_id, user_id, and agno.agent.name.

​
Troubleshooting

  • Instrument once at process start before agent calls.
  • Confirm OTEL_EXPORTER_OTLP_HEADERS contains X-Agnost-Org-ID=<your-org-id>.
  • If child team spans are missing, confirm the parent Agno agent is instrumented before teams are constructed.

​
References