.NETアプリケーションインストルメンテーション

最終更新日: 13 年 2023 月 XNUMX 日

OpenTelemetryを利用した.NETアプリケーションのインストルメンテーションには、次の方法を使用できます。

  • (推奨) 自動計装-このオプションは開始するための最速の方法ですが、トレースデータの出力方法をあまり制御できません。 LogicMonitorは、.NETアプリケーションの自動インストルメンテーション用のウィザードを提供します。
    または、LogicMonitorポータルの外部で.NETアプリケーションを自動的に計測することもできます。 これには、使用中のサポートされているアプリケーションに固有のパッケージをダウンロードし、OTLPエクスポーターを構成して、インストルメント化された.NETアプリケーションを実行する必要があります。 操作名は自動的に設定されます。 詳細については、を参照してください。 サポートされているアプリケーション OpenTelemetryから。
  • 手動計装-これは、自動インストルメンテーションでサポートされていないライブラリとフレームワークを使用するアプリケーションの唯一のオプションです。 手動インストルメンテーションでは、OpenTelemetrySDKを使用してトレースデータをキャプチャして出力するコードをアプリケーションに記述します。

環境によっては、自動計装と手動計装の両方の組み合わせが必要になる場合があります。

LogicMonitorを使用して.NETアプリケーションをインストルメント化するための要件

.NETアプリケーションをインストルメント化するには、トレースデータをLogicMonitorポータルに転送するようにOpenTelemetryCollectorをインストールして構成する必要があります。 詳細については、を参照してください。 OpenTelemetryコレクターのインストール.

LogicMonitorのインストルメンテーションウィザードを使用して.NETアプリケーションを自動的にインストルメント化する

注: LogicMonitorポータルの外部でJavaアプリケーションを自動的に計測するには、OpenTelemetryのを参照してください。 自動計装 のドキュメントで詳しく説明されています)。

  1. MFAデバイスに移動する  形跡 > 新人研修 をクリックして アプリケーションをインストルメント化する.
  2.  選択 .NETの場合は、 自動(推奨).
  3. .NET SDKをダウンロードして、アプリケーションに挿入します。 このSDKは、OpenTelemetryが提供する.NETSDKのLogicMonitorラップバージョンです。
  4. プロンプトが表示されたら、次の情報を入力します。
    • (必須)インストルメントしているサービスの名前
      これは、LogicMonitorポータルのサービスの表示名としても使用されます。 スペースを含む特殊文字は使用できません。
    • (推奨)サービスの名前空間
      これは、サービスのグループ化を表すために使用されます。 指定すると、自動作成された各サービスにプロパティとして追加され、名前空間を表す親サービスが作成されます。 これは、複数の基盤となるサービスを使用してアプリケーションを整理する場合に役立ちます。
    • (推奨)カスタムタグ
      これらは、このサービスのすべての操作に関連付けられています。 たとえば、サービスのビジネスまたは技術的な優先順位を表すタグを追加できます。

注: LogicMonitorでは、トレースを既存の監視対象リソースにマッピングするために、ip、resource.type(kubernetes-pod、cloud、またはhostに設定する必要があります)およびhost.name(Kubernetesのポッド名である必要があります)のカスタムタグが必要です。 可能な場合はこれらのカスタムタグを使用して、トレースがログ、メトリック、およびアラートのコンテキストで表示されるようにします。

  1. 提供した情報に基づいて生成された環境変数をコピーし、アプリケーションを開始する前にそれらをアプリケーションに追加します。 

注: OpenTelemetry Collectorが別のサーバーにインストールされている場合は、 Dotel.export.otlp.endpoint ローカルホストからOpenTelemetryCollectorが実行されているサーバーのIPへ。

.NETアプリケーションを手動でインストルメント化する

アプリケーションがOpenTelemetry自動インストルメンテーションでサポートされていない場合、または自動インストルメンテーションによるトレースの生成方法をカスタマイズする場合は、.NETアプリケーションを手動でインストルメントできます。 たとえば、操作の命名方法をカスタマイズしたい場合があります。 自動インストルメンテーションでサポートされていないアプリケーションの詳細については、を参照してください。 OpenTelemetry .NET OpenTelemetryから。

.NETアプリケーションであるOpenTelemetrySDKを手動でインストルメント化し、トレースを作成および強化する方法の詳細については、OpenTelemetryのを参照してください。 手動計装 のドキュメントで詳しく説明されています)。

記事上で