---
name: "Trace and debug agent runs with AgentOps"
slug: "trace-and-debug-agent-runs-with-agentops"
description: "Instrument agent sessions so operators can replay runs, track model costs, inspect tool calls, and compare behavior across frameworks."
github_stars: 5640
verification: "security_reviewed"
source: "https://github.com/AgentOps-AI/agentops"
author: "AgentOps AI"
publisher_type: "organization"
category: "Monitoring & Alerts"
framework: "Multi-Framework"
tool_ecosystem:
  github_repo: "AgentOps-AI/agentops"
  github_stars: 5640
---

# Trace and debug agent runs with AgentOps

Instrument agent sessions so operators can replay runs, track model costs, inspect tool calls, and compare behavior across frameworks.

## Prerequisites

AgentOps Python SDK or supported framework integration, AgentOps API key or self-hosted deployment, agent runtime using OpenAI Agents SDK, CrewAI, Agno, LangChain, AutoGen/AG2, CamelAI, or another supported integration

## Installation

Use the upstream install or setup path that matches your environment:
- pip install agentops
- pip install openai-agents
- npm install agentops @openai/agents
- pip install 'crewai[agentops]'

Requirements and caveats from upstream:
- python
- Build multi-agent systems with tools, handoffs, and guardrails. AgentOps natively integrates with the OpenAI Agents SDKs for both Python and TypeScript.
- [Python integration guide](https://docs.agentops.ai/v2/integrations/openai_agents_python)

Basic usage or getting-started notes:
- | ⚒️ **Self-Host** | Want to run AgentOps on your own cloud? You're covered |
- Initialize the AgentOps client and automatically get analytics on all your LLM calls.
- [Get an API key](https://app.agentops.ai/settings/projects)

- Source: https://github.com/AgentOps-AI/agentops
- Extracted from upstream docs: https://raw.githubusercontent.com/AgentOps-AI/agentops/HEAD/README.md

## Documentation

- https://docs.agentops.ai

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/trace-and-debug-agent-runs-with-agentops/)
