SuperAPI AI 工具集

setup-browser-sdk-sourcemaps

数据与分析

查看项目

更新于 10-15 20:33

技能介绍

用途:为前端项目添加构建时 sourcemap 上传,使每次部署都能向 RUM 与 Error Tracking 提供未压缩堆栈,并自动附加 Git 元数据,把错误链接回源文件。

主要能力:支持 esbuild(任意版本)、Rollup >=3 <5、Rspack 1.x/2.x、Vite >=5 <=8、webpack >=5 <6;通过对应插件(@datadog/esbuild-plugin、@datadog/rollup-plugin、@datadog/rspack-plugin、@datadog/vite-plugin、@datadog/webpack-plugin)接入,插件需放在 plugins 数组首位。可选子选项 dryRun、bailOnError、maxConcurrency。

使用方式(须按 7 步顺序):1) 检测构建器配置;2) 收集 service、releaseVersion、minifiedPathPrefix 三个必填值,缺失时须向用户询问;3) npm install --save-dev @datadog/<bundler>-plugin;4) 开启构建器自身 sourcemap 输出(如 webpack 的 devtool: 'source-map'、Vite 的 build.sourcemap: true);5) 将插件写入配置;6) 在构建环境设置 DATADOG_API_KEY(或 DD_API_KEY),非 US1 组织设置 DATADOG_SITE(或 DD_SITE);7) 验证。

限制:Next.js 与 Turbopack 不在范围内,需改用 datadog-ci sourcemaps upload CLI。该技能只对已有 RUM 配置添加 sourcemap 上传,不会自行接入 RUM,且 service、releaseVersion 必须与 datadogRum.init() 中一致,minifiedPathPrefix 必须为完整 URL 或以 / 开头。不要将 API key 写入配置文件;dryRun 不被视为安全测试手段。