otel-js について
otel-js は、Node.js と JavaScript/TypeScript サービスで OpenTelemetry を扱うためのリファレンススキルです。設定やバージョン、移行情報の参照先を案内します。
主な機能
- 01宣言型 YAML 設定の資料
- 02ESM と CJS の読み込み案内
- 032.x から 3.0 への移行情報
- 04上流資料への参照先
活用シーン
- 01Node.js の OpenTelemetry 設定
- 02SDK パッケージのバージョン確認
- 03OpenTelemetry のアップグレード確認
インストール
コマンドをコピーしてターミナルで実行します。
$
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 までの Experimental 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 対応