SuperAPI AI 工具集

sentry-advanced-troubleshooting

通用与其它

查看项目

更新于 10-15 23:29

技能介绍

用途:该技能用于处理超出基础配置范围的 Sentry 疑难问题,包括事件静默丢弃、source map 无法解析、跨服务分布式追踪断链、SDK 内存泄漏、与其他可观测库冲突、网络层 DSN 阻断以及自定义传输问题。

主要能力:一是分层诊断事件丢失,检查客户端是否存活、DSN 是否有效可达、beforeSend 是否返回 null、采样率是否为 0,并发送测试事件与 flush 验证投递;可包裹 transport 打印出站 envelope。二是调试 source map,使用 sentry-cli releases files <release> list 列出资件,用 sentry-cli sourcemaps explain --org ... --project ... EVENT_ID 定位 URL 前缀与堆栈地址不匹配;上传前可用 sentry-cli sourcemaps upload --release=... --url-prefix=... --validate --dry-run 预检。三是修复分布式追踪断链,确认出站调用处于 Sentry.startSpan() 上下文内,并配置 tracePropagationTargets 只向自有服务传播 sentry-trace 与 baggage 头。四是内存泄漏诊断,长期运行进程需下调 maxBreadcrumbs(如 20)并过滤 console 集成。五是 SDK 冲突与网络问题,含 OpenTelemetry 双注册(skipOpenTelemetrySetup: true 并接入 SentrySpanProcessor)、winston/pino 冲突、代理与防火墙诊断。

使用方式:需已安装并初始化 Sentry SDK v8;准备应用日志、Sentry 控制台与项目设置访问权限;安装 Sentry CLI(npm install -g @sentry/cli);具备 curl、dig 等网络诊断工具;排障时在 SDK init 中启用 debug: true。

适用场景与限制:适用于 Node.js 与 Python 等长驻服务的生产级排障。文中所述症状与解决对照表覆盖 debug 无输出、flush 超时、source map 文件错误、重复事件、堆内存增长、追踪被拆分、OpenTelemetry 双重追踪等。具体环境差异与版本行为需以实际验证为准;未提供不支持平台或收费等信息。