Skip to main content

CrewAI integration for Agent Observability - multi-agent logging, cost tracking, and compliance

Project description

Agent Observability for CrewAI

PyPI version Python 3.10+ License: MIT

Multi-agent observability for CrewAI — track costs, tasks, and delegations across your crew.

Installation

pip install agent-observability-crewai

With CrewAI dependencies:

pip install agent-observability-crewai[crewai]

Quick Start

1. Get API Key

curl -X POST https://api-production-0c55.up.railway.app/v1/register \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"my-crew"}'

2. Set Environment Variable

export AGENT_OBS_API_KEY=ao_live_your_key_here

3. Add to Your Crew

from crewai import Agent, Task, Crew
from agent_observability_crewai import AgentObservabilityTool

# Create tool for each agent
obs_tool = AgentObservabilityTool(crew_id="research-crew")

researcher = Agent(
    role="Researcher",
    goal="Find accurate information",
    tools=[obs_tool],
    verbose=True
)

writer = Agent(
    role="Writer",
    goal="Create compelling content",
    tools=[AgentObservabilityTool(crew_id="research-crew", agent_role="writer")],
    verbose=True
)

# Create and run crew
crew = Crew(
    agents=[researcher, writer],
    tasks=[...]
)

result = crew.kickoff()

Automatic Callback (Alternative)

For fully automatic logging without giving agents the tool:

from crewai import Crew
from agent_observability_crewai import ObservabilityCallback

callback = ObservabilityCallback(crew_id="my-crew")

crew = Crew(
    agents=[...],
    tasks=[...],
    callbacks=[callback]  # Logs automatically
)

What Gets Tracked

Event Description
task_started When a task begins
task_complete Task finished with duration
delegation Task delegated between agents
tool_use Agent uses a tool
api_call External API calls
error Errors and failures

CrewAI-Specific Features

Per-Agent Cost Tracking

# Each agent logs with their role
obs = AgentObservabilityTool(
    crew_id="sales-crew",
    agent_role="lead-qualifier"
)

# Query later: "Show me costs for lead-qualifier role"

Task Delegation Logging

obs_tool.log_delegation(
    from_agent="Manager",
    to_agent="Researcher",
    task="Find competitor pricing",
    reason="Requires web search expertise"
)

Task Completion with Metrics

obs_tool.log_task_complete(
    task_description="Research competitors",
    output="Found 5 competitors...",
    cost_usd=0.15,
    duration_ms=45000
)

Pricing

Tier Logs/Month Price
Free 100,000 $0
Starter 1,000,000 $29/month
Professional 10,000,000 $199/month

Why Use This for CrewAI?

Multi-agent systems need observability more than single agents:

  • Which agent costs the most? Track per-role spending
  • Where are bottlenecks? See task durations per agent
  • Delegation chains Audit who delegated what to whom
  • Debug failures Trace errors back through agent interactions

Related Packages

License

MIT License — see LICENSE for details.

Links

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agent_observability_crewai-1.2.1.tar.gz (7.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agent_observability_crewai-1.2.1-py3-none-any.whl (8.5 kB view details)

Uploaded Python 3

File details

Details for the file agent_observability_crewai-1.2.1.tar.gz.

File metadata

File hashes

Hashes for agent_observability_crewai-1.2.1.tar.gz
Algorithm Hash digest
SHA256 b8eb6944eb08ab7b72814f4d1fe8c990f56d8ba5cea9b469f9f660d28e352233
MD5 77787e5975bd0309d97df6de8b178ab0
BLAKE2b-256 7bdd4e06bb52a215fe60d078b8933310869e90a60b3e640f34d382ebe2779002

See more details on using hashes here.

File details

Details for the file agent_observability_crewai-1.2.1-py3-none-any.whl.

File metadata

File hashes

Hashes for agent_observability_crewai-1.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4940b2e94071c855ab1a64fe143dcbb7d65df5fbc13aa9629294f14d446f209d
MD5 b17f5c44755455af1d5143a10bbe6b46
BLAKE2b-256 0ad8ab2b6b1bde9d05cbaf198e4a45ae088fbb5e2e39c358f60849d21473cff4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page