用途：在任意项目中接入 Sentry 自定义指标，用于追踪计数器、仪表和分布，或为应用做性能测量。当用户要求添加 Sentry metrics、追踪自定义指标，或涉及 Sentry.metrics、sentry_sdk.metrics 时可使用。
主要能力：提供三类指标——计数器（累计计数，如 API 调用、点击、错误）、仪表（时间点数值，如队列深度、内存、连接数）、分布（统计值，如响应时间、购物车金额）。示例覆盖 JavaScript（10.25.0+，Sentry.metrics.）、Python（2.44.0+，sentry_sdk.metrics.）、Ruby（6.3.0+，Sentry.metrics.*），三者均为 Open Beta。
使用方式：JavaScript 与 Python 在对应版本中指标默认启用，直接调用 count、gauge、distribution 并传入单位与 attributes 即可；可通过 beforeSendMetric / before_send_metric 过滤敏感指标。资料还给出计时辅助函数（withTiming、track_duration）与 Ruby 调用示例。常用单位包括 millisecond、second、minute、hour、byte、kilobyte、megabyte、usd、eur、gbp、none、percent、ratio。
最佳实践与验证：单条指标事件控制在 2KB 以内，属性集保持精简；名称使用命名空间（如 api.request.duration）；进程退出前调用 Sentry.flush()。添加指标后触发对应代码路径，在 Sentry 的 Explore > Metrics 面板查看，指标可能因缓冲区刷新延迟数分钟出现。
限制：资料明确提醒 SDK 版本、API 名称和代码示例仅为示例，实现前须对照 docs.sentry.io 核实，因 API 与最低版本可能已变化；如指标未出现需检查 SDK 版本、DSN 并等待缓冲刷新，指标被静默丢弃通常是超过 2KB，过多指标可用 beforeSendMetric 过滤。