用途：帮助在项目中配置 Sentry 自定义指标，用于跟踪计数器、仪表和分布三类数据，覆盖 JavaScript/TypeScript（SDK 10.25.0+，含 Next.js、React、Node.js、Browser）与 Python（SDK 2.44.0+，含 Django、Flask、FastAPI 及通用 Python）。Ruby 当前在 Sentry SDK 中无专用指标支持。
主要能力：内建三种指标。Counter 跟踪累计次数（按钮点击、API 调用、错误），支持 sum、per_second、per_minute 聚合；Gauge 记录时间点快照（队列深度、内存、连接数），支持 min、max、avg；Distribution 对数值做统计分析（响应时间、客单价、查询耗时），支持 p50、p75、p95、p99、avg、min、max。
使用方式：先确认 SDK 版本，JS 用 grep -E '"@sentry/(nextjs|react|node|browser)"' package.json，Python 用 pip show sentry-sdk | grep Version，低于最低版本需升级（如 npm install @sentry/nextjs@latest、pip install --upgrade sentry-sdk）。指标在满足版本后默认开启，无需改动 Sentry.init()。可选在 beforeSendMetric（JS）或 before_send_metric（Python）中过滤或修改指标，也可用 enableMetrics: false 关闭。调用方式：JS 为 Sentry.metrics.count(name, value, options)、Sentry.metrics.gauge(...)、Sentry.metrics.distribution(...)，Python 为 sentry_sdk.metrics.count(name, value, **kwargs) 等；可指定 unit（如 millisecond、byte、usd、percent），并可通过 await Sentry.flush() 手动发送。
适用场景：业务 KPI、应用健康（错误率、延迟）、资源使用、用户行为等。不适合做基础设施监控、日志聚合或完整请求追踪，属性应避免高基数和敏感数据。
限制：需满足最低 SDK 版本；指标发送前会缓冲，可能需等待或手动 flush；Ruby 暂不支持；官方资料未提供收费与价格信息。