用途:该技能聚焦 Sentry SDK 侧的接入与使用,帮助 TypeScript 项目实现错误监控与性能追踪。项目级 Sentry 合规(DSN 管理、CI 中 Source Map 上传)应使用 /configure:sentry,本地逐步调试使用 typescript-debugging。
主要能力:自动错误捕获与堆栈跟踪;基于分布式追踪的性能监控;定时任务 Cron 监控;Source Map 集成以还原可读的 TypeScript 堆栈;通过 tags、breadcrumbs、用户数据补充上下文;结构化日志转发(enableLogs);CPU/JS 性能分析(Node.js 与浏览器);带隐私控制的会话回放;用户反馈组件;以及自定义上下文、breadcrumb 分类、指纹等增强辅助。
安装:Bun 用 bun add @sentry/bun;Node.js 用 bun add @sentry/node;Next.js 用 bun add @sentry/nextjs @sentry/profiling-node;React/浏览器用 bun add @sentry/react 或 bun add @sentry/browser;CLI 用 bun add -D @sentry/cli。Source Map 可用 npx sentry-cli sourcemaps inject ./dist && npx sentry-cli sourcemaps upload ./dist,或用 npx @sentry/wizard@latest -i sourcemaps 配置。
常用 API:captureException 捕获异常并可附带 tags、extra、level;captureMessage 发送文本消息;captureCheckIn 用于 Cron 检查;addBreadcrumb 记录操作轨迹;setTag、setExtra、setUser、withScope 管理上下文;startSpan 创建性能跨度;withMonitor 监控定时任务。严重级别包括 fatal、error、warning、info、debug。
配置项:dsn、environment、release、tracesSampleRate、tracesSampler、sendDefaultPii、integrations、enableLogs、profileSessionSampleRate、profileLifecycle、replaysSessionSampleRate、replaysOnErrorSampleRate、ignoreErrors、beforeSend、beforeSendTransaction、beforeSendLog。
适用场景:需要统一收集前后端错误、追踪性能瓶颈、监控定时任务、还原 Source Map 或采集用户反馈的 TypeScript 应用。限制:资料未提供具体收费、价格、平台支持范围与效果数据;更多高级示例与最佳实践见 REFERENCE.md。