# JavaScript

> <img width="35" class="img-initial otel-icon" src="/img/logos/32x32/JS_SDK.svg" alt="JavaScript"> OpenTelemetry 在 JavaScript 中的特定语言实现（适用于 Node.js 和浏览器）。

---

LLMS index: [llms.txt](/llms.txt)

---


这是 OpenTelemetry JavaScript 的文档。 OpenTelemetry 是一个可观测性框架，这个框架提供了
API、SDK 以及一系列工具，用于辅助生成以及收集应用的遥测数据，比如链路、指标、日志。
通过本文档，你将了解如何开始使用 OpenTelemetry JavaScript。

## 状态以及版本发布 {#status-and-releases}

OpenTelemetry JavaScript 的当前主要功能组件状态如下：

| 链路                | 指标                 | 日志              |
| ------------------- | -------------------- | ----------------- |
| [Stable](/docs/specs/otel/versioning-and-stability/#stable) | [Stable](/docs/specs/otel/versioning-and-stability/#stable) | [Development](/docs/specs/otel/versioning-and-stability/#development) |

我们可以在 [Releases][] 中找到所有已发布的版本，包括[最新发布的版本][latest release]。 

[latest release]: <https://github.com/open-telemetry/opentelemetry-js/releases/latest>
[Releases]: <https://github.com/open-telemetry/opentelemetry-js/releases>
{{__hugo_ctx/}}



<div class="alert alert-warning" role="alert"><div class="h4 alert-heading" role="heading">Warning</div>



浏览器端插桩目前处于实验阶段，且大部分功能尚未标准化。若您有意参与贡献，可联系[客户端插桩特别兴趣小组][sig]。

[sig]: https://docs.google.com/document/d/16Vsdh-DM72AfMg_FIt9yT9ExEWF4A_vRbQ3jRNBe09w

</div>

{{__hugo_ctx/}}


## 版本支持 {#version-support}

OpenTelemetry JavaScript 支持所有处于活跃或维护 LTS 版本的 Node.js。
旧版本的 Node.js 可能也能使用，但 OpenTelemetry 不会对其进行测试。

OpenTelemetry JavaScript 没有官方支持的浏览器列表。它旨在主流浏览器的当前受支持版本上正常运行。

OpenTelemetry JavaScript 遵循 DefinitelyTyped 的 TypeScript 支持政策，该政策设定了 2 年的支持周期。
对于超过 2 年的旧版 TypeScript，OpenTelemetry JavaScript 将在小版本更新中停止支持。

有关运行时支持的更多详细信息，请参阅[概述](https://github.com/open-telemetry/opentelemetry-js#supported-runtimes)。

## 仓库 {#repositories}

OpenTelemetry JavaScript 由以下仓库组成：

- [opentelemetry-js](https://github.com/open-telemetry/opentelemetry-js), 核心仓库，包含核心分发的 API 和 SDK。
- [opentelemetry-js-contrib](https://github.com/open-telemetry/opentelemetry-js-contrib), 贡献项，不属于 API 和 SDK 核心分发内容。

## 帮助或反馈 {#help-or-feedback}

如果您对 OpenTelemetry JavaScript 有任何疑问，
请通过 [GitHub 讨论区](https://github.com/open-telemetry/opentelemetry-js/discussions)或 [CNCF Slack](https://slack.cncf.io/) 的 `#otel-js` 频道联系我们。

如果您想为 OpenTelemetry JavaScript 做出贡献，
请参阅[贡献说明](https://github.com/open-telemetry/opentelemetry-js/blob/main/CONTRIBUTING.md)。

---

Section pages:

- [开始](/zh/docs/languages/js/getting-started/): 开始使用适用于 Node.js 和浏览器的 OpenTelemetry。
- [插桩](/zh/docs/languages/js/instrumentation/): OpenTelemetry JavaScript 插桩工具
- [使用插桩库](/zh/docs/languages/js/libraries/): 如何为应用所依赖的库进行插桩
- [导出器](/zh/docs/languages/js/exporters/): 处理并导出你的遥测数据
- [上下文](/zh/docs/languages/js/context/): OpenTelemetry JavaScript 上下文 API 文档
- [传播](/zh/docs/languages/js/propagation/): 上下文传播 JS SDK
- [资源](/zh/docs/languages/js/resources/): 在你的遥测数据中添加有关应用程序环境的详细信息
- [采样](/zh/docs/languages/js/sampling/): 减少遥测数据量
- [Serverless](/zh/docs/languages/js/serverless/): 使用 OpenTelemetry JavaScript 为 Serverless 函数添加插桩
- [基准测试](/zh/docs/languages/js/benchmarks/)
- [API 参考文档](/zh/docs/languages/js/api/): 请查阅 OpenTelemetry JavaScript API 参考文档_（外部页面）_
- [示例](/zh/docs/languages/js/examples/): 探索 OpenTelemetry JavaScript 的更多示例 _（外部页面）_
- [资源目录](/zh/docs/languages/js/registry/): 用于 OpenTelemetry JavaScript 的插桩库、导出器和其他有用组件