儀錶板設定

儀錶板會在啟動時設定。 設定包括前端和 OpenTelemetry 通訊協定 （OTLP） 位址、資源服務端點、驗證、遙測限制等等。

當儀錶板以 .NET.NET Aspire 應用程式主機項目啟動時，會自動設定為顯示應用程式的資源和遙測。 在 獨立模式中啟動儀錶板時，提供組態。

提供組態的方式有很多：

• 命令行自變數。
• 環境變數。 : 分隔符應取代為環境變數名稱中的雙底線（__）。
• 選擇性 JSON 組態檔。 DOTNET_DASHBOARD_CONFIG_FILE_PATH 設定可用來指定 JSON 組態檔。

請考慮下列範例，示範如何從 Docker 容器啟動時設定儀錶板：

docker run --rm -it -p 18888:18888 -p 4317:18889 -d --name aspire-dashboard \
    -e DASHBOARD__TELEMETRYLIMITS__MAXLOGCOUNT='1000' \
    -e DASHBOARD__TELEMETRYLIMITS__MAXTRACECOUNT='1000' \
    -e DASHBOARD__TELEMETRYLIMITS__MAXMETRICSCOUNT='1000' \
    mcr.microsoft.com/dotnet/aspire-dashboard:9.0

docker run --rm -it -p 18888:18888 -p 4317:18889 -d --name aspire-dashboard `
    -e DASHBOARD__TELEMETRYLIMITS__MAXLOGCOUNT='1000' `
    -e DASHBOARD__TELEMETRYLIMITS__MAXTRACECOUNT='1000' `
    -e DASHBOARD__TELEMETRYLIMITS__MAXMETRICSCOUNT='1000' `
    mcr.microsoft.com/dotnet/aspire-dashboard:9.0

或者，您可以使用使用 DOTNET_DASHBOARD_CONFIG_FILE_PATH指定的 JSON 組態檔來設定這些相同的值：

{
  "Dashboard": {
    "TelemetryLimits": {
      "MaxLogCount": 1000,
      "MaxTraceCount": 1000,
      "MaxMetricsCount": 1000
    }
  }
}

一般設定

前端驗證

儀錶板前端端點驗證已設定為 Dashboard:Frontend:AuthMode。 前端可以使用 OpenID Connect （OIDC） 或瀏覽器令牌驗證來保護。

瀏覽器令牌驗證的運作方式是要求令牌的前端。 令牌可以在UI中輸入，或以查詢字串值的形式提供給登入頁面。 例如，https://localhost:1234/login?t=TheToken。 成功驗證令牌時，驗證 cookie 會保存至瀏覽器，並將瀏覽器重新導向至應用程式。

OTLP 驗證

OTLP 端點驗證是使用 Dashboard:Otlp:AuthMode來設定。 OTLP 端點可以使用 API 金鑰或 client 憑證 驗證來保護。

API 金鑰驗證的運作方式是要求每個 OTLP 要求都有有效的 x-otlp-api-key 標頭值。 它必須符合主要或次要金鑰。

OTLP CORS

跨原始來源資源分享 （CORS） 可以設定為允許瀏覽器應用程式將遙測傳送至儀錶板。

根據預設，瀏覽器應用程式會限制進行跨網域 API 呼叫。 這會影響將遙測傳送至儀錶板，因為儀錶板和瀏覽器應用程式一律位於不同的網域上。 若要設定 CORS，請使用 Dashboard:Otlp:Cors 區段，並指定允許的來源和標頭：

{
  "Dashboard": {
    "Otlp": {
      "Cors": {
        "AllowedOrigins": "http://localhost:5000,https://localhost:5001"
      }
    }
  }
}

請考慮下列組態選項：

資源

儀錶板會連線到資源服務，以載入和顯示資源資訊。 client 是在儀錶板中設定，以瞭解如何連線到服務。

資源服務 client 驗證是使用 Dashboard:ResourceServiceClient:AuthMode來設定。 client 可以設定為支援 API 金鑰或 client 憑證驗證。

遙測限制

遙測會儲存在記憶體中。 為了避免記憶體使用量過多，儀錶板有儲存遙測計數和大小的限制。 達到計數限制時，會新增新的遙測，並移除最舊的遙測。 達到大小限制時，數據會截斷為限制。

遙測限制會根據遙測類型而有不同的範圍：

• MaxLogCount 和 MaxTraceCount 會跨資源分享。 例如，MaxLogCount 值為5,000的儀錶板會設定儀錶板，以儲存所有資源的最多5,000個記錄專案。
• MaxMetricsCount 是每個資源。 例如，MaxMetricsCount 值為10,000的儀錶板會設定每個資源最多10,000個計量數據點。

其他

後續步驟