SuperAPI AI 工具集

sentry-setup-ai-monitoring

部署与运维

查看项目

更新于 10-15 21:51

技能介绍

用途:在项目中配置 Sentry AI Agent Monitoring,用于追踪 LLM 调用、智能体执行、工具使用、对话与 token 消耗,适用于需要 AI 可观测性、模型延迟或成本分析的场景。

主要能力:支持 JavaScript(openai、@anthropic-ai/sdk、Vercel AI、LangChain/LangGraph、@google/genai)、Python(openai、anthropic、langchain、huggingface_hub、google-genai、pydantic-ai、mcp 等,安装后自动启用)、PHP/Laravel(laravel/ai,需 Laravel 12.x 与 sentry/sentry-laravel 4.27.0+)。可采集 gen_ai.* 跨度,包括模型、token 用量、延迟、工具调用与智能体生命周期;Conversations 视图按 gen_ai.conversation.id 分组多轮会话。

使用方式:先检测已安装的 AI SDK,再检查 tracesSampleRate/traces_sample_rate。AI 监控要求 tracing 开启(tracesSampleRate > 0);生产环境建议降低采样率或使用 tracesSampler 对 AI 事务保持 100%。Node.js 中集成通常自动启用;浏览器/Next.js 的 OpenAI 需手动包装 Sentry.instrumentOpenAiClient(new OpenAI());Vercel AI 需每次调用设置 experimental_telemetry。Python 初始化时设置 send_default_pii=True 可捕获提示词。Laravel 需 composer require sentry/sentry-laravel "^4.27.0" 与 laravel/ai,并在 .env 设置 SENTRY_TRACES_SAMPLE_RATE=1.0。无受支持 SDK 时可按 gen_ai.* 约定手动埋点。

限制与注意:提示词与输出捕获可能包含 PII,JS 默认开启(受 dataCollection.genAI 控制),Python 需 send_default_pii=True,Laravel 需 SENTRY_SEND_DEFAULT_PII=true;启用前须确认隐私政策与法规合规,并征得用户明确同意。Cloudflare Workers 不支持 monkey-patching,需使用 Vite 插件或手动包装。cached/reasoning token 是总量的子集,上报错误会导致成本为负。SDK 版本与 API 可能变化,实施前应核对 docs.sentry.io。具体价格与更多平台细节暂未提供。