CrewAIInstrumentor. Model spans come from the provider client that CrewAI actually calls underneath. This page uses OpenAI-backed CrewAI flows, so it layers OpenAIInstrumentor on top of CrewAIInstrumentor.
Quick Start
Last tested with
crewai 1.15.23, openinference-instrumentation-crewai 1.1.18, and openinference-instrumentation-openai 0.1.61 (September 2026).openai/gpt-4o-mini, so they use OpenAIInstrumentor. If your CrewAI app uses another provider, use the matching provider instrumentor when one exists.
Required Environment Variables
HH_INGESTION_API_KEY- Your HoneyHive ingestion API keyOPENAI_API_KEY- Required for the examples on this pageHH_API_URL- Optional override for non-production HoneyHive environments
What Gets Traced
This setup captures:- Crew runs - Crew kickoff spans and multi-step execution
- Agent activity - Agent roles, prompts, and outputs for each task
- Model requests - OpenAI-backed LLM calls with prompt and response payloads
- Tool usage - Each CrewAI tool run, with its arguments and result
- Flows -
Flow.kickoff()runs and each flow method step - Standalone agents -
Agent.kickoff()calls made outside a crew
@trace decorators are required for the standard CrewAI path.
Tool events require openinference-instrumentation-crewai 1.1.11 or later. Earlier versions do not emit spans for @tool-decorated functions.
Example: Support Agent with Tool Calls
Troubleshooting
Traces not appearing
- Check environment variables - Ensure
HH_INGESTION_API_KEYis set - Pass the tracer provider - Both instrumentors must receive
tracer_provider=tracer.provider:
- Instrument your provider -
CrewAIInstrumentorcaptures orchestration spans; you also need the matching provider instrumentor for model input/output details - Check your model provider - Ensure the API key for your chosen model provider is set (e.g.,
OPENAI_API_KEY)
Related
Enrich Your Traces
Add user IDs and custom metadata to CrewAI traces
Custom Spans
Create spans for business logic around agent calls
Distributed Tracing
Trace agents across service boundaries