SuperAPI AI 工具集

sentry-performance-tracing

部署与运维

查看项目

更新于 10-15 23:29

技能介绍

用途:为应用接入 Sentry 性能监控与分布式追踪,测量延迟、定位瓶颈、跟踪 Web Vitals。

主要能力:v8 SDK 以 startSpan() 取代已弃用的 startTransaction();自动插桩覆盖 HTTP、数据库查询与框架路由;手动 span 测量关键业务操作;通过 profilesSampleRate 获取函数级火焰图;分布式追踪跨服务传播 sentry-trace 与 baggage 头;浏览器端自动采集 LCP、INP、CLS、TTFB。

使用方式:前提是 @sentry/node >= 8.0.0 或 sentry-sdk >= 2.0.0 已安装,Sentry.init() 中 tracesSampleRate > 0,项目设置启用性能监控,跨服务追踪需各服务均初始化 SDK。初始化时设 tracesSampleRate;tracesSampler 定义后优先于前者。自定义业务逻辑用 Sentry.startSpan()(自动结束)、startSpanManual()(需在 finally 手动 span.end())或 startInactiveSpan()(后台任务)。属性用 span.setAttribute(),指标用 Sentry.setMeasurement()。Express 等框架默认自动插桩,需将 Sentry.setupExpressErrorHandler(app) 放在所有路由之后。非 HTTP 传输需手动提取并注入 sentry-trace/baggage。

适用场景:Node.js 与 Python 后端性能分析、Express/FastAPI/Django/Flask 路由埋点、数据库与缓存调用分析、微服务跨服务链路追踪、前端 Web Vitals 监控。

限制:采样率未设 > 0 则无事务数据;span 名称应参数化(如 /api/users/:id),避免高基数;子 span 须在父回调内创建才会嵌套;profilesSampleRate 需安装 @sentry/profiling-node。其余信息暂未提供。