mcpField
O
otel-dotnet

otel-dotnet

github.com/ollygarden開発11796 回インストール2 日前に更新
リポジトリ

otel-dotnet について

.NET サービスで OpenTelemetry を設定、計装、調整するための参考資料をまとめた Skill です。.NET 開発者向けに SDK 設定、API、自動・手動計装、最近の変更を扱い、.NET には公開済みの宣言的設定実装がまだありません。

主な機能

  1. 01.NET SDK とエクスポーターの設定案内
  2. 02Activity、メトリクス、ログの計装説明
  3. 03ゼロコード計装と手動計装の紹介
  4. 04サンプリング、バッチ処理、終了時調整の資料
  5. 05API の非推奨化とセマンティック規約変更の確認

活用シーン

  1. 01.NET サービスへの OpenTelemetry 設定
  2. 02トレース、メトリクス、ログの計装追加
  3. 03サンプリング、エクスポート、終了処理の調整

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/otel-dotnetを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
api.md
breaking-changes.md
instrumentation-libraries.md
performance.md
setup.md

詳細

.NET の OpenTelemetry

.NET サービスにおける OpenTelemetry の仕組みの入口です。タスクに応じて、以下のリファレンスを参照してください。それぞれのリファレンスは単独で利用できます。

リファレンス

ファイル次の場合に使用
references/setup.mdDI／ビルダー経由で SDK を設定する場合（AddOpenTelemetry().WithTracing/WithMetrics/WithLogging、UseOtlpExporter、OpenTelemetrySdk.Create、OpenTelemetry.Extensions.Hosting）、エクスポーターの配線、環境変数／IConfiguration による入力、.NET でリリース済みの宣言型 YAML 設定が存在しない理由。
references/api.mdネイティブ BCL API（ActivitySource／Activity、System.Diagnostics.Metrics.Meter、ILogger）による計装、SDK のサブスクライブ方法（AddSource／AddMeter）、属性、伝搬、およびオプションの OTel API シム。
references/instrumentation-libraries.mdゼロコード（opentelemetry-dotnet-instrumentation CLR プロファイラーエージェント）、contrib 計装パッケージのカタログ、semconv に準拠した手動計装。
references/performance.mdサンプリングの調整（AlwaysRecordSampler を含む組み込みサンプラー）、バッチエクスポートプロセッサー、定期メトリクスリーダー、ビュー、エクスポーターの選択、非同期コンテキスト、グレースフルシャットダウン。
references/breaking-changes.md最近の core／contrib リリースにおける非推奨／名称変更された API と semconv の変更について、既存コードを監査する場合。

信頼できる情報源

YAML スキーマの詳細（言語に依存しない）については、otel-declarative-config スキルを参照してください。ただし、.NET にはまだリリース済みの宣言型設定実装がありません（references/setup.md を参照）。 .NET 固有の情報については、以下を参照してください。

情報取得方法
最新の OpenTelemetry core／core-* タグgh api repos/open-telemetry/opentelemetry-dotnet/releases/latest -q '.tag_name'
最新の NuGet パッケージ（OpenTelemetry、OpenTelemetry.Extensions.Hosting、エクスポーター、OpenTelemetry.Instrumentation.<pkg>）WebFetch https://www.nuget.org/packages/<PackageId>（Version）
最新の自動計装エージェントgh api repos/open-telemetry/opentelemetry-dotnet-instrumentation/releases/latest -q '.tag_name'
core CHANGELOG（監査対象のリリース時点におけるパッケージごとの変更履歴）WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-dotnet/<core-tag>/src/<Package>/CHANGELOG.md
contrib CHANGELOG（各パッケージのリリースタグ時点におけるパッケージごとの変更履歴）WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-dotnet-contrib/<package-tag>/src/<Package>/CHANGELOG.md
.NET の入門／計装ドキュメントWebFetch https://opentelemetry.io/docs/languages/dotnet/instrumentation/
ゼロコードエージェントのドキュメントWebFetch https://opentelemetry.io/docs/zero-code/dotnet/

相互参照

  • スキーマレベルの情報：otel-declarative-config スキル（言語に依存しない YAML スキーマの情報源。.NET はまだ実装されていません）。
  • 言語間での SDK バージョンの選択：otel-sdk-versions スキル。
  • セマンティック規約の検索：otel-semantic-conventions スキル。

コメント

Markdown 対応