mcpField
O
otel-js

otel-js

github.com/ollygardenDevelopment117126 installsUpdated 2d ago
Repository

About otel-js

otel-js is a reference skill for applying OpenTelemetry in Node.js and JavaScript/TypeScript services. It directs users to setup guidance and authoritative sources for configuration, package versions, and migrations.

Key features

  1. 01Declarative YAML setup reference
  2. 02ESM and CJS import guidance
  3. 032.x to 3.0 migration notes
  4. 04Pointers to upstream sources

Use cases

  1. 01Configuring OpenTelemetry in Node.js
  2. 02Checking SDK package versions
  3. 03Reviewing an OpenTelemetry upgrade

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ollygarden/opentelemetry-agent-skills --skill otel-js

After installing, type/otel-jsin Claude Code to confirm it loaded.

Bundled filesreferences/declarative-setup.md

Details

From the project README

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

FileUse when
references/declarative-setup.mdConfiguring the SDK via declarative YAML: OTEL_CONFIG_FILE, @opentelemetry/configuration, @opentelemetry/sdk-node, ESM/CJS import order, 2.x and 3.0 migration notes.

Sources of Truth

For YAML schema details, fetch the upstream sources listed in the otel-declarative-config skill. For Node.js-specific facts:

FactFetch
Latest @opentelemetry/configurationnpm view @opentelemetry/configuration version
Latest @opentelemetry/sdk-nodenpm view @opentelemetry/sdk-node version
Latest @opentelemetry/auto-instrumentations-nodenpm view @opentelemetry/auto-instrumentations-node version
Released package status / breaking changes (3.0.0 / 0.300.0, verified 2026-10-25)WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v3.0.0/experimental/packages/configuration/README.md and WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v3.0.0/experimental/packages/opentelemetry-sdk-node/README.md
Experimental CHANGELOG through 0.300.0WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v3.0.0/experimental/CHANGELOG.md
ESM / CJS preload mechanics at 3.0.0WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v3.0.0/doc/esm-support.md
Auto-instrumentations register entry point at 0.82.0 (first release on 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 migration (removed packages, Node.js floor)WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-js/v3.0.0/doc/3.x/migration-guide.md
Node.js getting-started docsWebFetch 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.

Comments

Markdown supported