可观测性【免费下载链接】sentry-javascriptOfficial Sentry SDKs for JavaScript项目地址https://gitcode.com/gh_mirrors/se/sentry-javascript点击查看免费下载本文基于 Sentry JavaScript SDK 仓库中的 v8 变更日志 系统梳理 SDK 8.x 完整版本周期8.0.0-rc 系列至 8.55.0的演进脉络8.0.0 的破坏性重构OpenTelemetry 化、Hub 移除、类集成废弃、版本支持范围、ESM 加载钩子的发展、各框架 SDK 的引入NestJS、Nuxt、Solid、Cloudflare以及 v8 周期内各关键版本新增的集成、配置选项与废弃项。读完后你可以快速判断项目应停留在 v8 的哪个版本以及升级到 v9 前需要处理哪些已废弃 API。1. v8 的生命周期状态先读这一条docs/changelog/v8.md 文件开头的官方声明是所有 v8 用户必须知道的前提Support for Sentry SDK v8 will be dropped soon. We recommend migrating to the latest version of the SDK.v8 的支持将很快结束建议迁移到最新版本。文档将 v8 到 v9 的迁移指向 v8 到 v9 迁移指南。因此这份 changelog 的定位是冻结版本的历史档案v8 分支仍在接收维护性补丁例如 8.55.0 中 AWS Lambda Layer 的更名但所有新特性都只合入主线。理解这一点是阅读下文所有条目的基调。2. 8.0.0 里程碑v8 周期的架构定调2.1 升级方式migr8 codemod 与迁移指南changelog 为 8.0.0 给出的升级路径是阅读官方迁移指南处理各平台的破坏性变更运行自动化迁移工具npx sentry/migr8latestv7 周期中除getCurrentHub()外的所有废弃 API 在 v8 中全部移除。仓库根目录的 MIGRATION.md 提供逐条变更的深入说明v8 changelog 中多处链接到该文件。2.2 版本支持范围这是决定能否升级的硬性事实以 8.0.0 条目为准Node 端sentry/node及所有基于 Node 的服务端 SDKsentry/nextjs、sentry/remix等要求Node.js 14.8.0 及以上基于 ESM 的 Node 应用需要Node.js 18.19.0 及以上由 ESM 加载钩子支持决定。浏览器端要求 ES2018 兼容浏览器浏览器最低版本Chrome71Edge79Safari / iOS Safari12.1 / 12.2Firefox65Opera58Samsung Internet10演进过程可在 changelog 中追溯8.0.0-alpha.4 阶段#10911先以 ES2017 目标弃用 IE11当时最低要求 Chrome 58 等8.0.0-beta.1 阶段收紧到 ES2018Chrome 63 等最终 8.0.0 定稿为上表。2.3 被移除/不再发布的包以下包自 v8 起停止发布这是迁移时的必查项包替代方式sentry/hub直接从sentry/node、sentry/react等 SDK 包导入sentry/tracing同上性能 API 已并入各 SDKsentry/integrations插件式集成改为从各 SDK 包直接导入sentry/serverless拆分为sentry/google-cloud-serverless与sentry/aws-serverlesssentry/replay回放能力并入sentry/browserreplayIntegrationsentry/opentelemetry-node8.0.0-alpha.2 移除直接用sentry/node内置 OTEL或sentry/opentelemetry手动对接2.4 集成改为函数式类集成全部移除v8 最直观的代码级变化是集成从类变为函数旧类导出被删除// old (v7) Sentry.init({ integrations: [new Sentry.BrowserTracing()], }); // new (v8) Sentry.init({ integrations: [Sentry.browserTracingIntegration()], });仓库根目录的 MIGRATION.md 中 Removal of class-based integrations 一节列出了完整的类到函数映射。2.5 服务端初始化顺序成为硬约束8.0.0-alpha.1 条目记录了 v8 最大的底层改动sentry/node全面转向 OpenTelemetry#10762。其带来的直接后果Express、Fastify、Koa、Nest.js 等框架的性能插桩开箱即用autoDiscoverNodePerformanceMonitoringIntegrations()不再需要必须先require/import并调用Sentry.init()再导入其他任何模块否则第三方包无法被插桩const Sentry require(sentry/node); Sentry.init({ dsn: ..., // ... other config here }); // now require other things below this! const http require(http); const express require(express);changelog 因此推荐把初始化放进独立文件如instrumentation.js并在入口文件最顶部导入。8.0.0 条目还明确建议为服务端 SDKNode、Bun、Deno、Serverless采用这种独立初始化文件模式。2.6 其他 8.0.0 破坏性细节移除transpileClientSDK#11978因弃用 IE11Next.js SDK 不再提供该选项需要旧浏览器支持时自行配置 Webpack 转译Serverless 不再默认携带性能集成#11998为控制 Lambda 包体积数据库等性能集成需手动加入Sentry.init使用 Sentry AWS Lambda layer 时除外移除 XHR transport#10703alpha.1 阶段浏览器默认改用基于 fetch 的传输无 fetch 的环境需自行 polyfill 或提供自定义 transport移除startTransaction、span.startChild()性能 API 全面重写为startSpan系列对应仓库文档 v8 新性能 API 说明移除 Transaction 概念#11422span 与 transaction 的边界被拉平。3. ESM 支持的演进从 loader 钩子到registerEsmLoaderHooksESM 插桩是 v8 周期跨多个版本逐步打磨的一条主线changelog 中可清晰看到四步演进8.0.0-alpha.9#11338服务端 SDK 首次附带 ESM 加载钩子使用方式# For Node.js 18.18.2 node --experimental-loadersentry/node/hook your-app.js # For Node.js 18.19.0 node --importsentry/node/register your-app.js当时上游存在 bug官方声明会在 8 正式版前修复。8.0.0-beta.1#11498钩子文件更名为loader/import命令变为node --loadersentry/node/loaderNode ≤ 18.18.2或node --importsentry/node/importNode ≥ 18.19.0。8.0.0-rc.2Sentry.init()本身即可在被--import标志加载的模块中完成 ESM 补丁注册官方注明仅支持 Node18.19.0及以上以及20.6.0及以上。8.3.0 与 8.5.0免代码初始化。支持通过 Node 标志直接完成初始化无需手写 init 文件# ESM SENTRY_DSNhttps://examplePublicKeyo0.ingest.sentry.io/0 node --importsentry/node/init app.mjs # CommonJS SENTRY_DSNhttps://examplePublicKeyo0.ingest.sentry.io/0 node --requiresentry/node/init app.js8.5.0 进一步增加sentry/node/preload钩子#12213先以node --require sentry/node/preload ./app.js启动之后可以在任意时机包括异步获取 DSN 后再调用Sentry.init()解决了无法在应用最开头初始化的场景。8.8.0#12388升级 OTEL 依赖并让 OTEL 使用import-in-the-middlev1.8.0集中修复了一批 ESM 场景问题多 loader 并存、date-fns重复命名空间导出、openai自引用导入、discord.js的ENOENT等。8.14.0 / 8.20.0 / 8.29.0Sentry.init新增registerEsmLoaderHooks选项8.20.0 允许把该选项传给preloadOpenTelemetry自定义 preload 脚本8.29.0 增加onlyIncludeInstrumentedModules: true选项只对有插桩的模块做包装减少干扰import * as Sentry from sentry/node; Sentry.init({ dsn: __PUBLIC_DSN__, registerEsmLoaderHooks: { onlyIncludeInstrumentedModules: true }, });值得注意的是 8.41.0 的废弃预告registerEsmLoaderHooks.include/exclude细粒度选项被废弃官方明确onlyIncludeInstrumentedModules: true将成为下一个大版本的默认行为且该选项不再接受细粒度配置。4. 版本周期中的框架 SDK 引入时间线v8 周期同时也是多个新框架 SDK 从 alpha 走到 beta 的周期changelog 为每个节点都有明确标注版本SDK/框架节点说明8.0.0-alpha.1NestJS 错误处理新增setupNestErrorHandler()#11375与 Koa 错误处理#114038.9.1sentry/solidSolid JS SDK alpha含 Solid Router 插桩与自定义 ErrorBoundary8.12.0Solid Router 集成简化breaking不再需要显式传入use*hooks直接使用solidRouterBrowserTracingIntegration()8.13.0 / 8.28.0sentry/nestjs8.13.0 alpha 发布8.28.0 进入 beta定位是sentry/node的 drop-in 替代8.21.0 / 8.22.0 / 8.23.0sentry/cloudflare8.21.0 alpha仅 Workers8.22.0 增加 Cloudflare Pages 插件sentryPagesPlugin8.23.0 增加 D1 插桩instrumentD1WithSentry8.25.0 / 8.29.0sentry/solidstart8.25.0 alpha8.29.0 与 Solid 一起进入 beta8.35.0sentry/nuxtbeta 发布服务端入口默认改为构建期动态import()包装BREAKING--import标志不再是必需8.36.0Next.js/Cloudflare/Vercel Edge 性能 OTEL 化事务命名对齐 OTel 语义约定服务端 pages router 事务更名为GET /path形式8.40.0Angular 19 支持配合provideAppInitializer调整TraceService初始化写法8.41.0Nuxt 最低版本正式要求 Nuxt ≥ 3.7.0且nitropack ^2.10.0、ofetch ^1.4.08.42.0React Router v7library 模式sentry/react增加支持8.43.0Astro 5 官方支持sentry/astro正式支持 Astro 5其中 Nuxt SDK 的三次行为调整值得单独注意均会导致初始化方式变化8.35.0默认改为 Rollup 插件在服务端入口外包裹动态import()官方提示不要再加--import标志否则会重复初始化出问题时可设sentry: { dynamicImportForServerEntry: false }回退。8.35.0sourcemap 改为必须显式开启客户端 sourcemapsourcemap: { client: true }目的是防止 sourcemap 意外泄露到公网。8.43.0又改回必须用--import初始化服务端 SDK以获得完整功能8.35.0 的动态import()默认方案对部分项目不适用无法使用该标志时可通过autoInjectServerSentry: top-level-import或experimental_dynamic-import在nuxt.config.ts中启用注入但存在追踪限制node --import ./.output/server/sentry.server.config.mjs .output/server/index.mjs// nuxt.config.ts sentry: { autoInjectServerSentry: top-level-import, },8.52.0 的 SolidStartwithSentry配置器下节详述延续了同一条把服务端配置注入构建产物的路线。5. 关键版本的特性深读5.1 8.55.0v8 周期末版本Lambda Layer 更名8.55.0 的重要变更对留在 v8 的 AWS Lambda 用户是关键信息TheSentryNodeServerlessSDKAWS Lambda Layer will stop receiving updates. If you intend to stay onv8and receive updates useSentryNodeServerlessSDKv8instead.即原SentryNodeServerlessSDKlayer 停止更新v8 用户需要切换到新 layer 名SentryNodeServerlessSDKv8才能继续获得更新。该版本的其他条目包括新增 Statsig 浏览器特性旗标集成flags/v8、补齐vercelAIIntegration导出、Nuxt 模块新增enabled选项用于完全禁用 Sentry、Vue SDK 支持 Pinia v3、React SDK 修复懒加载路由/组件的追踪等。5.2 8.52.0SolidStart 的withSentry配置包装器8.52.0 为 SolidStart 引入withSentry包装sentrySolidStartVite插件由withSentry自动添加import { defineConfig } from solidjs/start/config; import { withSentry } from sentry/solidstart; export default defineConfig( withSentry( {/* Your SolidStart config options... */}, { // Options for setting up source maps org: process.env.SENTRY_ORG, project: process.env.SENTRY_PROJECT, authToken: process.env.SENTRY_AUTH_TOKEN, }, ), );配合该变更Sentry 服务端配置不再需要放进public目录而是写入src/instrument.server.ts构建后落在服务端产物中作为instrument.server.mjs。服务端 SDK 的安装有两个选项**推荐**给启动命令加--import标志路径取决于你的服务端配置node --import ./.output/server/instrument.server.mjs .output/server/index.mjs设置autoInjectServerSentry: top-level-import把 Sentry 配置以顶层 import 注入服务端入口存在追踪限制withSentry( {/* Your SolidStart config options... */}, { // Optional: Install Sentry with a top-level import autoInjectServerSentry: top-level-import, }, );在当前仓库主分支中该配置器的实现位于 withSentry.ts说明这一 API 在后续版本中被保留并继续演进。5.3 8.51.0Prisma v6 兼容逃生舱8.51.0 为prismaIntegration增加prismaInstrumentation选项作为所有 Prisma 版本的逃生舱接入 Prisma v6 的性能数据需要三步安装prisma/instrumentationv6将其实例传入集成选项import { PrismaInstrumentation } from prisma/instrumentation; Sentry.init({ integrations: [ prismaIntegration({ // Override the default instrumentation that Sentry uses prismaInstrumentation: new PrismaInstrumentation(), }), ], });传入的实例会覆盖集成默认使用的插桩实例而prismaIntegration仍负责处理各 Prisma 版本间的数据兼容性 3. 从 Prisma schema 的 client generator 块中移除previewFeatures [tracing]。8.54.0 随后补了一条fix(node/v8): Add compatibility layer for Prisma v5说明 v8 分支持续在做 Prisma 多版本兼容维护。从当前仓库主分支的源码看Prisma 集成现在实现于 prisma/index.ts通过向globalThis.PRISMA_INSTRUMENTATION注册 tracing helper 直接兼容 Prisma v6/v7——也就是说 v8 中逃生舱要解决的版本错配问题在后续大版本中已通过全局 helper 机制原生解决。5.4 8.43.0特性旗标Feature Flags三件套8.43.0 一次性落地了三个特性旗标相关的浏览器集成均用于把 flag 评估数据附加到后续错误事件import * as Sentry from sentry/browser; Sentry.init({ integrations: [ // Track LaunchDarkly feature flags Sentry.launchDarklyIntegration(), // Track OpenFeature feature flags Sentry.openFeatureIntegration(), ], });以及用于手动追踪任意 flag 的通用 APIimport * as Sentry from sentry/browser; const featureFlagsIntegrationInstance Sentry.featureFlagsIntegration(); Sentry.init({ integrations: [featureFlagsIntegrationInstance], }); // Manually track a feature flag featureFlagsIntegrationInstance.addFeatureFlag(my-feature, true);当前主分支中这两个 SDK 集成的实现分别位于 launchdarkly 集成 与 openfeature 集成8.55.0 还继续为 v8 分支追加了 Statsig 集成可见特性旗标是贯穿整个 v8 周期后段的活跃方向。5.5 8.36.0SentryHttpInstrumentation与 Node HTTP 插桩重构8.35.0 的条目解释了这次重构的动机新增SentryHttpInstrumentation专门处理与 span 无关的 HTTP 插桩请求/会话/作用域相关与 OTel 的HttpInstrumentation并行运行从而改善自定义 OTel 配置下的兼容性、避免双方插桩互相冲突。同时httpIntegration重新引入spans: false选项关闭 span 发射但仍允许用户自定义HttpInstrumentationhttpIntegration({ spans: false })。同版本还有一项浏览器端行为变更流stream插桩改为默认关闭新增trackFetchStreamPerformance选项设为true时 Sentry 才对 fetch 流做插桩。5.6 8.26.0 与 8.30.0/8.31.0/8.38.0Node 集成全家桶v8 周期后段 Node 端持续扩充开箱集成changelog 中有明确标注的主要节点版本集成要点8.26.0fsIntegration插桩fsAPIspan 命名如fs.readFile、fs.unlink默认不启用支持recordFilePaths、recordErrorMessagesAsSpanAttributes选项官方警告高 I/O 场景如框架 dev server可能显著拖慢应用8.30.0kafkaIntegration插桩kafkajs默认自动启用也可Sentry.kafkaIntegration()手动加入8.31.0dataloaderIntegration自动插桩dataloader实例也可Sentry.dataloaderIntegration()手动加入8.32.0amqplibIntegrationAMQP 客户端插桩8.38.0knexIntegration/tediousIntegrationSQL 库插桩fsIntegration在 8.26.0 中的配置示例含两个风险相关的选项Sentry.init({ integrations: [ Sentry.fsIntegration({ recordFilePaths: true, recordErrorMessagesAsSpanAttributes: true, }), ], });在当前主分支中fsIntegration实现位于 node/src/integrations/fskafkajs/amqplib/dataloader等则集中在 server-utils/src/integrations可据此继续深入阅读具体插桩逻辑。5.7 8.16.0Next.js App Router 事务模型切换8.16.0#12729是 Next.js 用户必读的条目App Router 场景下SDK 从为每个顶层 Server Component 单独记录事务切换为把整个请求捕获为单一事务如GET /path/to/routeServer Component 的 span 作为其子 span。收益是trace 有根 span、客户端数据流的耗时不再丢失代价是 Sentry 中事务数量变少、span 变多对 SaaS 配额消耗有相应影响。Edge runtime 不受影响仍按旧方式发事务。5.8 8.12.0 与 8.11.0核心 API 的两个小升级Sentry.init()直接返回 client#12585不再需要再调getClient()const client Sentry.init();startSpan*系列新增parentSpan选项#12567可以显式指定 span 的父级Sentry.startSpan({ name: root }, parent { const span Sentry.startInactiveSpan({ name: xxx, parentSpan: parent }); Sentry.startSpan({ name: xxx, parentSpan: parent }, () {}); Sentry.startSpanManual({ name: xxx, parentSpan: parent }, () {}); });同版本还有maxSpanWaitDuration配置项#12610控制 SDK 等待父 span 结束的最长秒数超时会清理无父 span 的孤儿 span 以防内存泄漏如果你的应用有超长 span需要把该值调大否则 span 可能被过早丢弃。8.43.0 中还补了一个防护fix(node): Guard against invalid maxSpanWaitDuration values。5.9 8.6.0 与 8.16.0NestJS 的监控能力8.6.0 引入Sentry.reactErrorHandler用于 React 19 的hydrateRoot回调onUncaughtError/onCaughtErrorimport * as Sentry from sentry/react; import { hydrateRoot } from react-dom/client; ReactDOM.hydrateRoot( document.getElementById(root), React.StrictMode App / /React.StrictMode, { onUncaughtError: Sentry.reactErrorHandler(), onCaughtError: Sentry.reactErrorHandler((error, errorInfo) { // optional callback if users want custom config. }), }, );8.16.0 为sentry/nestjs增加SentryCron装饰器在 cron 任务前后向 Sentry 发送 check-inimport { Cron } from nestjs/schedule; import { SentryCron, MonitorConfig } from sentry/nestjs; import type { MonitorConfig } from sentry/types; const monitorConfig: MonitorConfig { schedule: { type: crontab, value: * * * * *, }, checkinMargin: 2, // In minutes. Optional. maxRuntime: 10, // In minutes. Optional. timezone: America/Los_Angeles, // Optional. }; export class MyCronService { Cron(* * * * *) SentryCron(my-monitor-slug, monitorConfig) handleCron() { // Your cron job logic here } }5.10 8.4.0Next.js App Router 客户端页面加载追踪8.4.0 在 Next.js14.3.0-canary.64及以上版本上为 React Server Components 的客户端页面加载加入追踪使Error: An error occurred in the Server Components render.这类之前无从查因的客户端错误可以回溯到具体的服务端组件错误。同版本还有 Angular 18 的正式支持。6. 废弃Deprecation清单v8 期间预告的下个大版本变化v8 周期大量使用先废弃、下个大版本移除的策略这些条目集中描述了v9 将发生什么是评估升级成本的最高价值信息。按主题归类6.1 采样与追踪选项enableTracing废弃8.18.0#12897改用tracesSampleRate/tracesSampler要禁用性能监控则直接移除这两个选项。undefined传参语义变更8.41.0#14450当前Sentry.init({ tracesSampleRate: undefined })因 key 存在反而启用追踪不产生 span下个大版本将改为与不传一致禁用追踪。官方建议若你依赖现状显式设置tracesSampleRate: 0该写法在 v9 中同样启用追踪。tracesSampler、enableTracing同理。beforeSendSpan返回null的警告8.41.0#14433目前返回null可丢弃单个 span但这会在 trace 中制造空洞下个大版本起该钩子只能变更 span、不能丢弃 span8.41.0 起对丢 span 的用法发出警告且根 span 也会开始传入该钩子。官方建议改为在集成/插桩层控制 span 的产生。6.2 会话追踪autoSessionTracking废弃8.44.0#14640启用会话追踪的推荐方式是不再设置autoSessionTracking浏览器环境确保加入browserSessionIntegration该集成正是 8.43.0 新增服务端确保加入httpIntegration禁用会话追踪则移除browserSessionIntegration或服务端将httpIntegration的trackIncomingRequestsAsSessions设为false该选项 8.43.0 加入。RequestSession相关 API 废弃8.43.0#14566这些 API 主要供内部使用后续服务端 Release Health 能力改由集成管理SDK 不再暴露RequestSession概念。6.3 集成与包Metrics API 废弃8.37.0#14157Metrics beta 于 10 月 7 日结束下个大版本将移除该 API现有调用可继续工作但发送的数据不再被 Sentry 处理。sentry/utils废弃8.41.0#14431将并入sentry/core不再建议继续使用。debugIntegration与sessionTimingIntegration废弃8.40.0#14363记录出网事件改用 hooksbeforeSend、beforeSendTransaction会话时长数据改用Sentry.setContext()。Vue/Nuxt 追踪选项收口8.41.0 #14385、8.42.0 #14530Vue SDK 中分散在四处Sentry.init、tracingOptions、vueIntegration()及其tracingOptions的追踪配置最终只保留vueIntegration({ tracingOptions })一条路Nuxt 侧相应废弃Sentry.init里的tracingOptions改为在 vueIntegration 中配置// sentry.client.config.ts import * as Sentry from sentry/nuxt; Sentry.init({ // ... integrations: [ Sentry.vueIntegration({ tracingOptions: { trackComponents: true, }, }), ], });NestJS 系列重命名/合并8.40.0#14323/#14371/#14374WithSentry改为SentryExceptionCaptured纯重命名SentryTracingInterceptor、SentryService功能并入Sentry.init后废弃SentryGlobalGenericFilter、SentryGlobalGraphQLFilter统一由SentryGlobalFilter替代drop-insentry/node中的nestIntegration与setupNestErrorHandler废弃官方推荐迁移到专门的sentry/nestjs包。getDomElement废弃8.48.0#14799无替代方案直接移除即可。SvelteKitfetchProxyScriptNonce废弃8.51.0#15011。registerEsmLoaderHooks.include/exclude废弃8.41.0#14486见 3 节改由onlyIncludeInstrumentedModules表达。工具函数批量废弃8.41.0arrayify、flatten、urlEncode、validSeverityLevels、getNumberOfUrlSegments、memoBuilder、BAGGAGE_HEADER_NAME、makeFifoCache、addRequestDataToEvent、extractRequestData等——这些主要针对自建 SDK的使用者。Next.jshideSourceMaps类型废弃8.43.0#14594该功能 v8 已移除但当时忘记废弃v9 彻底清除。7. 数据质量修复升级后数字会变的两个版本changelog 中有两条明确警告升级后监控数据会发生变化的修复运维层面需要预期管理8.28.0LCP/FCP/FP 归一化逻辑移除#13502。此前 SDK 错误地处理了浏览器上报的原始值导致上报的 LCP/FCP/FP小于真实测量值升级到该版本后这三个指标会跳升Web Vitals Insights 中的性能分数可能相应下降——这是纠错不是劣化。8.36.0Next.js/Cloudflare/Vercel Edge 性能监控切换 OTEL#13889。事务命名与 OTel 语义约定对齐服务端 pages router 事务从/[param]/my/route变为GET /[param]/my/routeSentry 中的事务名称会出现明显差异。8. 版本时间线速查以下是 v8 周期内值得记住的节点完整逐版本条目以 docs/changelog/v8.md 为准版本关键事件8.0.0-alpha.1 ~ alpha.9sentry/node转向 OpenTelemetry移除sentry/hub/sentry/tracing/sentry/integrations与类集成Node ≥ 14.8.0ESM loader 钩子8.0.0-beta.1明确版本支持基线Node 14.8.0ES2018 浏览器suppressTracing等新 API8.0.0-beta.4INP 默认开启传输缓冲默认 30 → 64可用transportOptions.bufferSize覆盖replayCanvasIntegration新增maxCanvasSize默认 12808.0.0-rc.2Sentry.init()内注册 ESM 钩子Node 18.19.0 / 20.6.08.0.0正式版migr8 codemod、版本支持定稿、transpileClientSDK移除8.3.0免代码初始化node --importsentry/node/init/--require8.5.0sentry/node/preload钩子React 19 进入 peer deps8.9.1Solid SDK alpha8.9.0 发布失败8.10.0Remix 迁移到opentelemetry-instrumentation-remixautoInstrumentRemix: true8.12.0init()返回 clientdeleteSourcemapsAfterUploadmaxSpanWaitDuration8.16.0Next.js App Router 单一事务模型SentryCron8.21.0–8.23.0Cloudflare SDK alpha → Pages 插件 → D1 插桩8.26.0fsIntegration默认关闭8.28.0NestJS SDK betaWeb Vitals 数值纠错8.29.0Solid/SolidStart betaonlyIncludeInstrumentedModules8.35.0Nuxt SDK betaSentryHttpInstrumentationVue Pinia 插件8.36.0Next.js 等三端性能 OTEL 化事务名变化8.37.0NuxtpiniaIntegrationMetrics API 废弃8.40.0Angular 19NestJS 系列废弃8.43.0Nuxt--import强制化特性旗标三件套browserSessionIntegration8.44.0autoSessionTracking废弃8.47.0–8.49.0错误事件处理、Railway release 检测、ANR 多事件捕获等8.51.0Prisma v6 兼容逃生舱prismaInstrumentation8.52.0SolidStartwithSentry配置器8.55.0Lambda Layer 更名SentryNodeServerlessSDKv8v8 周期末版本9. 实践建议基于这份 changelog 的决策清单新项目直接采用最新版 SDK 并遵循 v8 到 v9 迁移指南 中列出的目标 API不要基于 v8 特有的过渡形态如autoSessionTracking、enableTracing搭建配置。必须留在 v8 的项目固定使用 8.55.0若使用 AWS Lambda layer切换到SentryNodeServerlessSDKv8命名以继续获得更新关注 8.28.0 与 8.36.0 两个数据突变版本在升级窗口提前同步监控告警阈值。评估 v8 → v9 的改造项优先核对第 6 节的废弃清单——采样选项tracesSampleRate: 0显式化、beforeSendSpan中丢 span 的用法、autoSessionTracking、Vue/Nuxt 追踪选项收口、NestJS 装饰器/过滤器重命名、以及是否仍在 importsentry/utils。ESM 项目升级到 8.8.0OTEL import-in-the-middlev1.8.0以获得最完整的 ESM 修复集合需要精细控制插桩范围时使用registerEsmLoaderHooks.onlyIncludeInstrumentedModules并对 v9 的默认收紧行为做预案。本文所有版本行为描述均来自 docs/changelog/v8.md 的对应版本条目源码级佐证参考 MIGRATION.md、v8 新性能 API、Prisma 集成实现、fsIntegration 实现、LaunchDarkly 集成实现 与 SolidStart withSentry 实现。赞分享可观测性【免费下载链接】sentry-javascriptOfficial Sentry SDKs for JavaScript项目地址https://gitcode.com/gh_mirrors/se/sentry-javascript点击查看免费下载相关推荐Sentry JavaScript SDK v7 版本全记录从 7.0.0 到 7.120.4 的演进路线、关键特性与迁移指南Sentry JavaScript SDK v7 版本全记录从 7.0.0 到 7.120.4 的演进路线、关键特性与迁移指南 本文以 sentry java可观测性Sentry JavaScript SDK v6 变更日志精读从 6.0.0 到 6.19.7 的完整演进、废弃 API 与迁移要点Sentry JavaScript SDK v6 变更日志精读从 6.0.0 到 6.19.7 的完整演进、废弃 API 与迁移要点 Sentry JavaS可观测性SQLAlchemy 2.0 演进全记录从 2.0.0 到 2.0.55 的关键变更、修复路线与升级要点SQLAlchemy 2.0 演进全记录从 2.0.0 到 2.0.55 的关键变更、修复路线与升级要点 SQLAlchemy 2.0 系列是 Python数据库后端ORM上一篇告别代码沟通难题js2flowchart实时协作功能让团队效率倍增下一篇VictoriaMetrics实战指南构建企业级监控系统的5大核心策略创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考