SuperAPI AI 工具集

sentry-local-dev-loop

编程与开发

查看项目

更新于 10-15 23:29

技能介绍

用途:在本地开发阶段合理配置 Sentry,让开发事件与生产隔离、日志更详细、采样率更高,便于调试,同时用环境变量避免 DSN 泄露进版本库。

主要能力:按 NODE_ENV 等环境变量在开发/生产 DSN 之间切换;开发时开启 debug、tracesSampleRate 与 sampleRate 设为 1.0、sendDefaultPii;通过 beforeSend 与 beforeSendTransaction 将异常和事务耗时打印到控制台;启用 Sentry Spotlight 在本地浏览器查看事件;用 sentry-cli 上传并校验 source map;配 pre-push 钩子阻止硬编码 DSN 入库。

使用方式:安装 @sentry/node v8+ 或 sentry-sdk v2+,创建独立开发项目与 .env(含 SENTRY_DSN_DEV、NODE_ENV=development)。初始化文件用 node --import ./instrument.mjs app.mjs 加载;Spotlight 用 npx @spotlightjs/spotlight 启动,默认端口 8969。离线模式可将 dsn 设为空字符串,capture 调用变为 no-op。source map 用 sentry-cli info 验证、sentry-cli sourcemaps upload 与 explain 校验。验证脚本用 Sentry.startSpan() 做本地性能分析,并以 Sentry.flush(5000) 确保事件发出。

适用场景:Node/TypeScript 或 Python 应用的本地开发调试、离线或 CI 环境、发布前 source map 检查。

限制:需网络访问 *.ingest.sentry.io,或改用 Spotlight 完全离线;100% 采样可能触及配额,建议使用独立开发项目;示例中的环境变量与端口为资料给定值,实际配额、价格与平台细节暂未提供。