Basic Agent Tracing

Enable tracing for an agent in AgentOS. Set tracing=True and all agent runs, model calls, and tool executions are captured automatically.

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)

Set up your virtual environment

uv venv --python 3.12
source .venv/bin/activate

uv venv --python 3.12
.venv\Scripts\activate

Install dependencies

uv pip install -U openai agno fastapi uvicorn sqlalchemy opentelemetry-api opentelemetry-sdk openinference-instrumentation-agno

Export your OpenAI API key

export OPENAI_API_KEY="your_openai_api_key_here"

$Env:OPENAI_API_KEY="your_openai_api_key_here"

Run AgentOS

python basic_agent_tracing.py

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

Filter Options Basic Team Tracing

⌘I

Get Started

AgentOS

Example Usage

Basic Agent Tracing