SuperAPI AI 工具集

sentry-rate-limits

通用与其它

查看项目

更新于 10-15 23:29

技能介绍

用途:控制 Sentry 事件量、采样与配额,在保留关键错误可见性的同时降低成本,适用于遇到 429、需要调优采样或过滤噪声错误的场景。

主要能力:

  • 理解限流行为:超配额返回 429 Too Many Requests 与 Retry-After,SDK 在冷却期内停止发送,期间事件永久丢失,无重放机制。配额类别(分别计费)包括 Errors、Transactions、Replays、Attachments、Profiles、Cron monitors。
  • 客户端采样:设置 sampleRate(错误)与 tracesSampleRate(事务),或用 tracesSampler 做按路由的动态采样,如 /health 返回 0、支付/认证返回 1.0、API 返回 0.2、静态资源返回 0。
  • beforeSend 过滤:丢弃浏览器扩展错误、ResizeObserver、AbortError 等噪声事件,并用 ignoreErrors、denyUrls 按模式过滤,可强制保留支付类错误。
  • 服务端入站过滤器:在计数前过滤,不消耗配额,如 legacy browsers、browser extensions、localhost、web crawlers,可通过 Project Settings 或 API 启用。
  • 按 Key 限流:为每个 DSN 设置每小时事件上限,避免单项目耗尽组织配额。
  • 突发保护:Team/Business 计划自动启用,检测事件量突增并临时限流。
  • 用量监控:通过 /stats_v2/ API 按类别、项目、outcome 查询用量,可编写脚本告警。
  • 减小载荷与去重:调整 maxBreadcrumbs、maxValueLength,截断请求体、移除 cookies,并用自定义 fingerprint 归一化动态值。

必要用法:需 Sentry 账户与项目 DSN、具备 org:read 与 project:write 权限的 SENTRY_AUTH_TOKEN,以及 SENTRY_ORG、SENTRY_PROJECT。安装 @sentry/node(npm)或 sentry-sdk(pip)。使用 tracesSampler 时应移除 tracesSampleRate,二者会冲突。

限制:具体计划对应的 API 速率限制、价格与配额上限以官方合同和账户实际设置为准,资料未提供实时数值保证;错误处理的对应措施仅为资料所列建议。