# @grafana/faro-web-tracing 中文文档

规范地址：https://npmcn.com/package/%40grafana/faro-web-tracing/

版本：2\.14\.0
npm 元数据更新时间：2026-11-09T15:58:52.858Z
中文译文更新时间：2026-11-16T21:42:13.482Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40grafana/faro-web-tracing
原文对照：https://npmcn.com/package/%40grafana/faro-web-tracing/?lang=original
项目主页：https://github.com/grafana/faro-web-sdk
源码仓库：https://github.com/grafana/faro-web-sdk

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：892 kB，86 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：11 个
- 首次发布：2022-10-31T12:07:38.873Z
- 最新版本发布：2026-11-09T15:58:52.421Z
- 近 30 天下载量：4746150（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：103（近 12 个月 26 个）

## 中文简介

法罗网络追踪执行.

## 安装

```sh
npm install @grafana/faro-web-tracing
```

也可以使用：`pnpm add @grafana/faro-web-tracing`、`yarn add @grafana/faro-web-tracing`、`bun add @grafana/faro-web-tracing`

## README

# @grafana/faro-web-追踪

此软件包为整合提供了工具 [打开几何](https://opentelemetry.io/docs/instrumentation/js/) 与《京都议定书》 [网络法罗](https://github.com/grafana/faro-web-sdk/tree/main/packages/web-sdk)。 。 。 .

见 [快速启动文档](https://github.com/grafana/faro-web-sdk/blob/main/docs/sources/tutorials/quick-start-browser.md) 说明如何设置和使用.

## 一个页面上的多个法罗实例(微前端)

OpenTeleometry 仅允许单个全局跟踪器提供者、 传播器和上下文管理器 浏览上下文,获取/XHR仪器补丁全局 `fetch`编号 :`XMLHttpRequest` 仅限 一次 一次吗 因此,当几个法罗实例在同一页上运行时(例如: 微前端架构 ), **只有初始化的追踪拥有它**: 它登记 追踪器提供者和仪器获取/XHR。 任何法罗实例 `TracingInstrumentation` 之后检测到现有的所有者,记录一个警告,而不注册第二个提供者或 re-patch fear/XHR(这也避免了OpenTelemetry"重复注册"出错).

结果, **所有跨度均由自有实例导出** - 利用其出口商和资源 (单位:千美元)`service.name`它的收藏家,无论是谁创造的,只有主人 生成自动取取/XHR跨度。 以后没有登记自己的出口商,所以从未 导出直接跨度;它们仍然可以通过 `faro.api.getOTEL()` (例如手动跨度),但这些跨度由自有实例导出 并归咎于它。 这适用于不论 `isolate` 配置选项, 因为跟踪提供者 注册和获取/XHR补丁本质上是全球性的.

跨原生的痕迹标本传播在各种情况中都有所保留: `propagateTraceHeaderCorsUrls` 合并为所有者, 因此自有实例仍然注入 W3C 任意实例配置的 URL 的跟踪头 。 默认自定义跨度属性 (单位:千美元)`applyCustomAttributesOnSpan`)不合并——只适用所有者.

## 常见问题

### @grafana/faro-web-tracing 是什么？

法罗网络追踪执行\.

### 如何安装 @grafana/faro-web-tracing？

在项目目录运行 npm install @grafana/faro-web-tracing，或使用 pnpm add / yarn add / bun add。

### @grafana/faro-web-tracing 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @grafana/faro-web-tracing 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @grafana/faro-web-tracing 可以商用吗？

@grafana/faro-web-tracing 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @grafana/faro-web-tracing 的下载量有多少？

根据 npm 官方下载统计，@grafana/faro-web-tracing 在 2026/10/17 – 2026/11/15 这 30 天内被下载 4,746,150 次，日均约 158,205 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @grafana/faro-web-tracing 还在维护吗？

最新版本 2\.14\.0 发布于 2026/11/09（7 天前）；至今共发布 103 个版本，其中过去 12 个月发布了 26 个；首次发布于 2022/10/31。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

