otel-js

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

OpenTelemetry in Node.js

Node.js 中的 OpenTelemetry

Entry point for OpenTelemetry mechanics in Node.js / JavaScript / TypeScript services. Load a reference below based on the task; each reference is self-contained.

Node.js / JavaScript / TypeScript 服务中 OpenTelemetry 机制的入门指南。根据任务需求选择下方的参考内容；每个参考内容都是独立完整的。

References

参考内容

File	Use when
`references/declarative-setup.md`	Configuring the SDK via declarative YAML: `OTEL_CONFIG_FILE` , `@opentelemetry/configuration` , `@opentelemetry/sdk-node` , ESM/CJS import order, v2.0 migration.

文件	使用场景
`references/declarative-setup.md`	通过声明式YAML配置SDK： `OTEL_CONFIG_FILE` 、 `@opentelemetry/configuration` 、 `@opentelemetry/sdk-node` 、ESM/CJS导入顺序、v2.0迁移。

Sources of Truth

权威来源

For YAML schema details, fetch the upstream sources listed in the

otel-declarative-config

skill. For Node.js-specific facts:

Fact	Fetch
Latest `@opentelemetry/configuration`	`npm view @opentelemetry/configuration version`
Latest `@opentelemetry/sdk-node`	`npm view @opentelemetry/sdk-node version`
Latest `@opentelemetry/auto-instrumentations-node`	`npm view @opentelemetry/auto-instrumentations-node version`
Released package status / breaking changes ( `2.10.0` / `0.221.0` )	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v2.10.0/experimental/packages/configuration/README.md` and `WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v2.10.0/experimental/packages/opentelemetry-sdk-node/README.md`
Experimental CHANGELOG through `0.221.0`	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v2.10.0/experimental/CHANGELOG.md`
ESM / CJS preload mechanics at `2.10.0`	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v2.10.0/doc/esm-support.md`
Auto-instrumentations register entry point at `0.79.0`	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js-contrib/auto-instrumentations-node-v0.79.0/packages/auto-instrumentations-node/README.md`
Node.js getting-started docs	`WebFetch https://opentelemetry.io/docs/languages/js/getting-started/nodejs/`

如需了解YAML schema详情，请获取

otel-declarative-config

技能中列出的上游来源。针对Node.js的专属信息：

信息内容	获取方式
最新版本的 `@opentelemetry/configuration`	`npm view @opentelemetry/configuration version`
最新版本的 `@opentelemetry/sdk-node`	`npm view @opentelemetry/sdk-node version`
最新版本的 `@opentelemetry/auto-instrumentations-node`	`npm view @opentelemetry/auto-instrumentations-node version`
已发布包的状态 / 破坏性变更（ `2.10.0` / `0.221.0` ）	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v2.10.0/experimental/packages/configuration/README.md` 和 `WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v2.10.0/experimental/packages/opentelemetry-sdk-node/README.md`
截至 `0.221.0` 的实验性变更日志	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v2.10.0/experimental/CHANGELOG.md`
`2.10.0` 版本的ESM / CJS预加载机制	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v2.10.0/doc/esm-support.md`
`0.79.0` 版本的自动插桩注册入口	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js-contrib/auto-instrumentations-node-v0.79.0/packages/auto-instrumentations-node/README.md`
Node.js 入门文档	`WebFetch https://opentelemetry.io/docs/languages/js/getting-started/nodejs/`

Cross-References

交叉参考

Schema-level facts:
```
otel-declarative-config
```
skill (language-agnostic YAML schema sources).
SDK version selection across languages:
```
otel-sdk-versions
```
skill.
Semantic conventions lookup:
```
otel-semantic-conventions
```
skill.

Schema层面的相关信息：
```
otel-declarative-config
```
技能（与语言无关的YAML schema来源）。
跨语言的SDK版本选择：
```
otel-sdk-versions
```
技能。
语义规范查询：
```
otel-semantic-conventions
```
技能。