用途:该技能用于在项目中配置 Sentry 的自定义指标功能,追踪计数器(counter)、仪表(gauge)和分布(distribution)三类指标,适用于业务 KPI、应用健康度、资源利用率和用户行为等场景。
平台支持:JavaScript/TypeScript(SDK 10.25.0+,含 Next.js、React、Node.js、Browser)与 Python(SDK 2.44.0+,含 Django、Flask、FastAPI)。Ruby 暂不支持专用指标。
主要能力:计数器记录累计发生次数(如点击、API 调用、错误),支持 sum、per_second 等聚合;仪表记录时间点快照(如队列深度、内存),支持 min、max、avg;分布用于数值统计分析(如响应时间、订单金额),支持 p50、p75、p95、p99 等分位。指标默认启用,可通过 beforeSendMetric / before_send_metric 过滤或修改,也可用 enableMetrics: false 关闭。
使用方式:先确认 SDK 版本(JS 用 grep 检查 package.json,Python 用 pip show sentry-sdk),低于最低版本需升级。JS 调用 Sentry.metrics.count/gauge/distribution,Python 调用 sentry_sdk.metrics.count/gauge/distribution,可传入 unit 与 attributes。必要时用 Sentry.flush() 手动发送。
限制与注意:属性应保持低基数,避免用户 ID、请求 ID 等;不适合基础设施监控、日志聚合或完整请求追踪;指标发送前有缓冲,需等待或手动 flush;指标与 trace 关联需启用 tracing。