SuperAPI AI 工具集

sentry-reference-architecture

部署与运维

查看项目

更新于 10-15 23:29

技能介绍

用途:为多服务组织设计生产级 Sentry 架构,适合规划 Sentry 推广、按团队拆分项目、搭建跨服务追踪与告警体系。

主要能力:项目拓扑策略(每服务一项目 / 共享项目);集中式 lib/sentry.ts 配置,统一 PII 清洗、采样率与噪音过滤;Express 与 FastAPI 错误中间件,按状态码分级捕获;HTTP 自动传播与消息队列手动传播(publishWithTrace/consumeWithTrace)的分布式追踪;基于 Ownership Rules 的团队告警路由与 P0-P3 分级;Monorepo 的 Source Map 上传(CLI 与 Webpack 插件);带单例、指标与优雅关闭的 SentryService 封装;健康检查排除。

使用方式:需 Sentry 组织(团队功能需 Business 及以上)、@sentry/node v8+、Node.js 18+,并安装 npm install @sentry/node @sentry/profiling-node。在各服务启动时先调用 initSentry 再加载其他被埋点模块;按服务顺序挂载请求处理、路由与错误处理中间件;CI 构建后运行 Source Map 上传脚本;通过 SentryService.getInstance 初始化。

限制:具体价格、配额与平台支持范围资料未提供;多数代码为示例实现,需按实际栈调整;非 HTTP 传输需手动传播 trace 头;健康检查须定义在中间件之前;共享项目模式在告警噪音超出单团队时应拆分。