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