mcpField
O
observability-edot-dotnet-instrument

observability-edot-dotnet-instrument

github.com/elasticクラウド・DevOps6022.7k 回インストール今日更新
リポジトリ

observability-edot-dotnet-instrument について

Elastic Distribution of OpenTelemetry(EDOT)で .NET アプリケーションを計装するためのスキルです。NuGet パッケージ、起動時の登録、OTLP 設定を案内し、プロバイダーの手動設定は不要です。

主な機能

  1. 01EDOT NuGet パッケージの追加
  2. 02起動時の EDOT 登録
  3. 03必須 OTLP 環境変数の設定
  4. 04管理 OTLP エンドポイントまたは EDOT Collector の使用
  5. 05従来の APM と EDOT の併用回避

活用シーン

  1. 01ASP.NET Core アプリケーションの計装
  2. 02.NET サービスのテレメトリー出力設定

インストール

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

$npx skills add https://github.com/elastic/agent-skills --skill observability-edot-dotnet-instrument

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

詳細

EDOT .NET 計装

変更を加える前に、セットアップガイドをお読みください。

ガイドライン

  1. NuGet パッケージ Elastic.OpenTelemetry と OpenTelemetry.Instrumentation.AspNetCore(ASP.NET Core アプリの場合)を追加します
  2. 起動時に EDOT を登録します。IHostApplicationBuilder で builder.AddElasticOpenTelemetry() を呼び出します(Program.cs または同等のファイル)。これを行わないと、テレメトリーは収集されません
  3. 必須の環境変数を正確に3つ設定します。
    • OTEL_SERVICE_NAME
    • OTEL_EXPORTER_OTLP_ENDPOINT — マネージド OTLP エンドポイントまたは EDOT Collector の URL を指定する必要があります。APM Server の URL は使用しないでください(apm-server、:8200、/intake/v2/events は使用しないでください)
    • OTEL_EXPORTER_OTLP_HEADERS — "Authorization=ApiKey <key>" または "Authorization=Bearer <token>"
  4. OTEL_TRACES_EXPORTER、OTEL_METRICS_EXPORTER、OTEL_LOGS_EXPORTER は設定しないでください。デフォルト値はすでに 適切です
  5. TracerProvider や MeterProvider を手動で設定しないでください。AddElasticOpenTelemetry() がすべて処理します
  6. クラシックな Elastic APM エージェント(Elastic.Apm.*)と EDOT を同じアプリケーションで同時に実行しないでください

例

完全な例については、EDOT .NET セットアップガイドをご覧ください。

コメント