sentry-setup-ai-monitoring
Setup Sentry AI Agent Monitoring in any project. Use when asked to monitor LLM calls, track AI agents, or instrument OpenAI/Anthropic/Vercel AI/LangChain/Google GenAI/Pydantic AI. Detects installed AI SDKs and configures appropriate integrations.
By getsentry · 819 installs
npx skills add getsentry/sentry-agent-skills --skill sentry-setup-ai-monitoring
Source repository · Upstream listing
Setup Sentry AI Agent Monitoring
Configure Sentry to track LLM calls, agent executions, tool usage, and token consumption.
Invoke This Skill When
User asks to "monitor AI/LLM calls" or "track OpenAI/Anthropic usage"
User wants "AI observability" or "agent monitoring"
User asks about token usage, model latency, or AI costs
Important: The SDK versions, API names, and code samples below are examples. Always verify against [docs.sentry.io](https://docs.sentry.io) before implementing, as APIs and minimum versions may have changed.
Prerequisites
AI monitoring requires tracing enabled ( tracesSampleRate 0 ).
Data Capture Warning
Prompt and output recording captures user content that is likely PII. Before enabling recordInputs / recordOutputs (JS) or include prompts / send default pii (Python), confirm:
The application's privacy policy permits capturing user prompts and model responses
Captured data complies with applicable regulations (GDPR, CCPA, etc.)
Sentry data retention settings are appropriate for the sensitivity of the data
Ask the user whether they want prompt/output capture enabled. Do not enable it by default — configure it only when explicitly requested or confirmed. Use tracesSampleRate: 1.0 only in development; in production, use a lower value or a tracesSampler function.
Detection First
Always detect installed AI SDKs before configuring:
Supported SDKs
JavaScript
Package Integration Min Sentry SDK Auto?
openai openAIIntegration() 10.28.0 Yes
@anthropic ai/sdk anthropicAIIntegration() 10.28.0 Yes
ai (Vercel) vercelAIIntegration() 10.6.0 Yes
@langchain/ langChainIntegration() 10.28.0 Yes
@langchain/langgraph langGraphIntegration() 10.28.0 Yes
@google/genai googleGenAIIntegration() 10.28.0 Yes
Vercel AI: 10.6.0+ for Node.js, Cloudflare Workers, Vercel Edge Functions, Bun. 10.12.0+ for Deno. Requires experimental telemetry per call.
Python
Integrations auto enable when the AI package is installed — no explicit registration needed:
Package Auto? Notes
openai Yes Includes OpenAI Agents SDK
anthropic Yes
langchain / langgraph Yes
huggingface hub Yes
google genai Yes
pydantic ai Yes
litellm No Requires explicit integration
mcp (Model Context Protocol) Yes
JavaScript Configuration
Node.js — auto enabled integrations
Just ensure tracing is enabled. Integrations auto enable when the AI package is installed:
To customize (e.g., enable prompt capture — see Data Capture Warning):
Browser / Next.js OpenAI (manual wrapping required)
In browser side code or Next.js meta framework apps, auto instrumentation is not available. Wrap the client manually:
LangChain / LangGraph (auto enabled)
Vercel AI SDK
Add to sentry.edge.config.ts for Edge runtime:
Enable telemetry per call:
Python Configuration
Integrations auto enable — just init with tracing. Only add explicit imports to customize options:
Manual Instrumentation
Use when no supported SDK is detected.
Span Types
op Value Purpose
gen ai.request Individual LLM calls
gen ai.invoke agent Agent execution lifecycle
gen ai.execute tool Tool/function calls
gen ai.handoff Agent to agent transitions
Example (JavaScript)
Key Attributes
Attribute Description
gen ai.request.model Model identifier
gen ai.request.messages JSON input messages
gen ai.usage.input tokens Input token count
gen ai.usage.output tokens Output token count
gen ai.agent.name Agent identifier
gen ai.tool.name Tool identifier
Enable prompt/output capture only after confirming with the user (see Data Capture Warning above).
Verification
After configuring, make an LLM call and check the Sentry Traces dashboard. AI spans appear with gen ai. operations showing model, token counts, and latency.
Troubleshooting
Issue Solution
AI spans not appearing Verify tracesSampleRate 0 , check SDK version
Token counts missing Some providers don't return tokens for streaming
Prompts not captured Enable recordInputs / include prompts
Vercel AI not working Add experimental telemetry to each call