otel-sdk-versions について
OpenTelemetry SDK、Collector、および関連コンポーネントのバージョンを調べるスキルです。付属の索引を基本資料として互換性のある依存関係を選び、索引にない情報は公式リリース資料で確認します。
主な機能
- 01言語別 SDK バージョンの確認
- 02Collector とコンポーネントの確認
- 03互換性に基づくバージョン選択
- 04リリース資料で関連パッケージを確認
活用シーン
- 01プロジェクトで使う SDK の選定
- 02Collector ビルド内のコンポーネント確認
- 03索引にないパッケージのバージョン調査
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ ollygarden/ opentelemetry-agent-skills --skill otel-sdk-versionsインストール後、Claude Code で/otel-sdk-versionsを入力して読み込まれたか確認します。
同梱ファイルreferences/generated/otel-version-index.md
詳細
OpenTelemetry SDK のバージョン
ワークフロー
references/generated/otel-version-index.mdを開きます。
- SDK の表には言語ごとに主要な SDK パッケージが 1 つ記載されています。Components の表には Collector(core、contrib、distributions、builder)、設定スキーマ、セマンティック規約、Weaver が含まれています
- 対象範囲については、同梱の表をデフォルトの信頼できる情報源として使用します
- 「Versions last changed」の日付は、いずれかの行が最後に変更された日です
- オフラインの場合は、各バージョンをこの日付とともに「
<version>(<date>時点)。それ以降に新しいリリースがある可能性があります」と示します。現在の最新バージョンとは決して呼ばないでください
- バージョンを慎重に選択します。
- プロジェクトとの互換性がある場合は、最新のリリース済みバージョンを優先します
- 最新リリースに互換性がない場合は、互換性のある最新バージョンを選び、その互換性上の理由を明記します
- 言語、パッケージ、または制約が変わらない限り、タスクの残りの部分でも同じ選択を使用します
- 関連パッケージのバージョンをリリースソースから確認します。
- 同じエコシステムの追加パッケージ(exporter、instrumentation、resource detector、Collector component)が必要な場合は、リリースソースでそれらのバージョンを調べます。主要パッケージのバージョンから推測したり、流用したりしないでください
- 同じプロジェクト内のサブパッケージは同じバージョン系列を共有することがよくありますが、常にそうとは限りません。各パッケージを個別に確認してください
- 1 つのビルドに含まれる Collector コンポーネントは、builder が使用する core のリリース系列と一致させる必要があります。この系列は core より遅れる場合があります。マニフェストでのバージョン固定については
otel-collector-builderを参照してください
- 必要に応じて、リンク先の追加情報を確認します。
- Release Source 列または Release 列を使用して、パッケージ、リポジトリ、またはリリースノートを確認します
- SDK のセットアップ方法については、Setup Docs 列を使用します
- 実装例がある場合は、Examples 列を使用して参照します
- 情報が不足している場合は、明示的に説明します。
- 要求された言語、パッケージ、またはコンポーネントが同梱のインデックスにない場合は、インデックスではカバーされていないことを伝えます
- そのうえで、そのパッケージの公式リリースソースと公式ドキュメントを参照します
- 未リリース、プレリリース、または互換性のないバージョンが許容されると、説明なしに決めつけないでください
コメント
Markdown 対応