Basic Agent Tracing

Trace agents with Agno in AgentOS.

This example shows how to enable tracing for an agent in AgentOS. Simply set tracing=True and all agent runs, model calls, and tool executions are automatically captured.

1. Create a Python file

   basic_agent_tracing.py

   from agno.agent import Agent
   from agno.db.sqlite import SqliteDb
   from agno.models.openai import OpenAIResponses
   from agno.os import AgentOS
   from agno.tools.hackernews import HackerNewsTools
   
   # Set up database
   db = SqliteDb(db_file="tmp/traces.db")
   
   agent = Agent(
       name="HackerNews Agent",
       model=OpenAIResponses(id="gpt-5.2"),
       tools=[HackerNewsTools()],
       instructions="You are a hacker news agent. Answer questions concisely.",
       markdown=True,
       db=db,
   )
   
   # Setup AgentOS with tracing enabled
   agent_os = AgentOS(
       description="Example app for tracing HackerNews",
       agents=[agent],
       tracing=True,  # Enable tracing for all agents
   )
   app = agent_os.get_app()
   
   if __name__ == "__main__":
       agent_os.serve(app="basic_agent_tracing:app", reload=True)
   
2. Set up your virtual environment

   Mac

   uv venv --python 3.12
   source .venv/bin/activate
   
3. Install dependencies

   uv pip install -U openai agno opentelemetry-api opentelemetry-sdk openinference-instrumentation-agno
   
4. Export your OpenAI API key

   Mac/Linux

   export OPENAI_API_KEY="your_openai_api_key_here"
   
5. Run AgentOS

   python basic_agent_tracing.py
   

   Your AgentOS will be available at http://localhost:7777. View traces in the AgentOS dashboard.