SuperAPI AI 工具集

sentry

部署与运维

查看项目

更新于 10-16 00:03

技能介绍

用途:该技能在用户需要接入或配置 Sentry 应用监控平台时触发,覆盖错误监控、性能追踪、会话回放、Cron 监控、告警和 Source Maps 等场景,支持 JavaScript、Python、Go、Ruby、Java 等 20 多个平台的 SDK。

主要能力:初始化 Sentry SDK(DSN、采样率、集成项);手动捕获异常与消息;设置用户、标签、上下文与面包屑;创建自定义 span 做性能监控;配置会话回放及隐私掩码;上传 Source Maps 还原堆栈;配置告警与采样策略;集成 Next.js、Django、Flask、Express 等框架;配置 Sentry CLI 用于发布与 CI/CD。

使用方式:通过环境变量提供 SENTRY_DSN、SENTRY_AUTH_TOKEN、SENTRY_ORG、SENTRY_PROJECT。安装命令如 npm install @sentry/browser、pip install sentry-sdk、npm install @sentry/node、npm install -g @sentry/cli。Next.js 可用 npx @sentry/wizard@latest -i nextjs 自动生成配置,Source Maps 可用 npx @sentry/wizard@latest -i sourcemaps 或 sentry-cli sourcemaps upload --release=my-app@1.0.0 ./dist。

限制与注意:Sentry.init() 必须最先执行,否则相关模块的错误与性能数据不会被捕获;生产环境 tracesSampleRate 设为 1.0 会快速消耗配额,建议用 tracesSampler 动态采样;Source Maps 必须在首次错误前按 release 上传;会话回放默认掩码文本与媒体,但通过 innerHTML 或 canvas 注入的内容不会自动掩码,启用前应在预发环境审查;Next.js 的 withSentryConfig 会包装并重写 next.config.js,需正确合并配置。常见错误包括无效 DSN、429 限流、Source Maps 未生效、隧道 CORS 错误、事件未出现等。详细子域内容可查阅 references/ 下的 sdk-configuration.md、nextjs-setup.md、api-cli.md,仅在需要时加载。