次の方法で共有

スタンドアロン .NET.NET Aspire ダッシュボード

  • [アーティクル]

.NET .NET Aspire ダッシュボード は、テレメトリを表示するための優れた UI を提供します。 ダッシュボード:

  • OpenTelemetry 対応アプリで使用できるコンテナー イメージとして出荷されます。
  • restの .NET Aspire なしでスタンドアロンで使用できます。

スタンドアロン モードで実行されている .NET.NET Aspire ダッシュボードのスクリーンショット。

ダッシュボードを開始する

ダッシュボードは、Docker コマンド ラインを使用して開始されます。

  • Bash
  • PowerShell の 
docker run --rm -it -d \
    -p 18888:18888 \
    -p 4317:18889 \
    --name aspire-dashboard \
    mcr.microsoft.com/dotnet/aspire-dashboard:9.0

上記の Docker コマンド:

  • mcr.microsoft.com/dotnet/aspire-dashboard:9.0 イメージからコンテナーを開始します。
  • コンテナーは、次の 2 つのポートを公開します。
    • ダッシュボードの OTLP ポート 18889 をホストのポート 4317にマッピングします。 ポート 4317 は、アプリから OpenTelemetry データを受信します。 アプリは、OpenTelemetry プロトコル (OTLP)を使用してデータを送信します。
    • ダッシュボードのポート 18888 をホストのポート 18888にマッピングします。 ポート 18888 にはダッシュボード UI があります。 ブラウザーで http://localhost:18888 に移動して、ダッシュボードを表示します。

ダッシュボードにログインする

ダッシュボードに表示されるデータは機密性の高い場合があります。 既定では、ダッシュボードは、ログインにトークンを必要とする認証で保護されます。

スタンドアロン コンテナーからダッシュボードを実行すると、ログイン トークンがコンテナー ログに出力されます。 強調表示されたトークンをログイン ページにコピーした後、[ログイン] ボタンを選択します。

.NET.NET Aspire ダッシュボード コンテナー ログのスクリーンショット。

先端

ログインを回避するには、DOTNET_DASHBOARD_UNSECURED_ALLOW_ANONYMOUS 環境変数を trueに設定することで、認証要件を無効にすることができます。 その他の構成については、「ダッシュボードの構成参照してください。

ダッシュボードへのログインの詳細については、「ダッシュボード認証」を参照してください。

ダッシュボードを探索する

ダッシュボードには、テレメトリを表示するための UI が用意されています。 テレメトリ機能の詳細については、ドキュメントを参照してください。

ダッシュボードの実行場所に制限はありませんが、ダッシュボードは開発および短期的な診断ツールとして設計されています。 ダッシュボードは、いくつかの制限を作成するメモリ内のテレメトリを保持します。

  • テレメトリ 制限 超えると、テレメトリは自動的に削除されます。
  • ダッシュボードを再起動しても、テレメトリは保持されません。

ダッシュボードには、.NET.NET Aspire リソースを表示するための機能もあります。 ダッシュボード リソース機能は、スタンドアロン モードで実行すると無効になります。 リソース UI を有効にするには、リソース サービスの構成を追加 。

ダッシュボードにテレメトリを送信する

アプリは、OpenTelemetry Protocol (OTLP)を使用してテレメトリをダッシュボードに送信します。 ダッシュボードは、OpenTelemetry データを受信するためのポートを公開する必要があり、アプリはそのアドレスにデータを送信するように構成されています。

ダッシュボードを開始 、 コマンドが前に表示されました。 ポート OpenTelemetryで 4317 データを受信するようにコンテナーを構成しました。 OTLP エンドポイントの完全なアドレスが http://localhost:4317。

OpenTelemetry SDK の構成

アプリは、言語の SDK使用してテレメトリを収集して送信します。

構成する SDK オプション OpenTelemetry 重要:

  • OTLP エンドポイント。ダッシュボードの構成 (たとえば、http://localhost:4317) と一致する必要があります。
  • OTLP プロトコル。ダッシュボードは現在、OTLP/gRPC プロトコルのみをサポートしています。 grpc プロトコルを使用するようにアプリケーションを構成します。

アプリケーションを構成するには:

  • アプリケーション内で OpenTelemetry SDK API を使用する、または
  • 既知の環境変数 でアプリを起動します。
    • OTEL_EXPORTER_OTLP_PROTOCOLの値を使用して grpc します。
    • OTEL_EXPORTER_OTLP_ENDPOINTの値を使用して http://localhost:4317 します。

見本

スタンドアロン ダッシュボードの使用例については、スタンドアロン .NET.NET Aspire ダッシュボード サンプル アプリのを参照してください。

次の手順

.NET .NET Aspire ダッシュボード を構成する