关于 otel-js
otel-js 是面向 Node.js 和 JavaScript/TypeScript 服务的 OpenTelemetry 参考技能,提供配置指引,并指向版本与迁移信息的权威来源。
主要功能
- 01声明式 YAML 配置参考
- 02ESM 与 CJS 导入指引
- 032.x 到 3.0 迁移说明
- 04指向上游权威资料
适用场景
- 01配置 Node.js 的 OpenTelemetry
- 02查询 SDK 软件包版本
- 03检查 OpenTelemetry 升级事项
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ ollygarden/ opentelemetry-agent-skills --skill otel-js安装后在 Claude Code 中输入/otel-js确认已加载。
附带文件references/declarative-setup.md
详细介绍
Node.js 中的 OpenTelemetry
Node.js / JavaScript / TypeScript 服务中 OpenTelemetry 机制的入口。 根据任务加载以下参考资料;每份资料均可独立使用。
参考资料
| 文件 | 使用场景 |
|---|---|
references/declarative-setup.md | 通过声明式 YAML 配置 SDK:OTEL_CONFIG_FILE、@opentelemetry/configuration、@opentelemetry/sdk-node、ESM/CJS 导入顺序、2.x 和 3.0 迁移说明。 |
权威来源
有关 YAML 架构的详情,请获取 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 |
已发布的软件包状态 / 破坏性变更(3.0.0 / 0.300.0,已于 2026-10-25 验证) | WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v3.0.0/experimental/packages/configuration/README.md 和 WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v3.0.0/experimental/packages/opentelemetry-sdk-node/README.md |
截至 0.300.0 的实验性 CHANGELOG | WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v3.0.0/experimental/CHANGELOG.md |
3.0.0 中的 ESM / CJS 预加载机制 | WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v3.0.0/doc/esm-support.md |
0.82.0 中的自动插桩注册入口(首个基于 SDK 3.x / API 1.10 的版本) | WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js-contrib/auto-instrumentations-node-v0.82.0/packages/auto-instrumentations-node/README.md |
| 2.x → 3.x 迁移(已移除的软件包、Node.js 最低版本) | WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v3.0.0/doc/3.x/migration-guide.md |
| Node.js 入门文档 | WebFetch https://opentelemetry.io/docs/languages/js/getting-started/nodejs/ |
交叉引用
- 架构层面的信息:
otel-declarative-config技能(与语言无关的 YAML 架构来源)。 - 跨语言的 SDK 版本选择:
otel-sdk-versions技能。 - 语义约定查询:
otel-semantic-conventions技能。
评论
支持 Markdown