otel-js

面向 Node.js/JavaScript/TypeScript 服务的 OpenTelemetry 参考技能，覆盖 NodeSDK、声明式 YAML 配置、自动插桩及 ESM/CJS 导入方式，并指引按任务加载子文档和核对上游版本。

ollygarden

热度 0.00

最近更新 2026-10-19 06:55:39

分类：开发依赖：读写文件 / 联网浏览搜索 / 代码执行应用场景：DevOps / API 集成 / 调试排错

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add ollygarden/opentelemetry-agent-skills/otel-js

Metadata

name: otel-js
description: OpenTelemetry in Node.js / JavaScript / TypeScript — NodeSDK, declarative YAML configuration, auto-instrumentations, ESM vs CJS import patterns. Use when adding, reviewing, or configuring OpenTelemetry in a Node.js service. Triggers on "setup otel in node", "js telemetry", "node tracing setup", "NodeSDK", "auto instrumentation node", "TracerProvider node", or any Node.js-related OTel question.

OpenTelemetry in Node.js

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

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.

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.11.0` / `0.222.0`)	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v2.11.0/experimental/packages/configuration/README.md` and `WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v2.11.0/experimental/packages/opentelemetry-sdk-node/README.md`
Experimental CHANGELOG through `0.222.0`	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v2.11.0/experimental/CHANGELOG.md`
ESM / CJS preload mechanics at `2.11.0`	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v2.11.0/doc/esm-support.md`
Auto-instrumentations register entry point at `0.80.0`	`WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js-contrib/auto-instrumentations-node-v0.80.0/packages/auto-instrumentations-node/README.md`
Node.js getting-started docs	`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.