共用方式為

在 Azure 容器應用程式中使用 .NET Aspire 儀表板讀取即時應用程式資料 (預覽)

  • 發行項

.NET Aspire 儀表板會顯示有關應用程式和其他資源在環境內執行方式的即時資料。

下圖是 .NET Aspire 儀表板所產生的追蹤視覺效果螢幕擷取畫面。

.NET Aspire 儀表板的追蹤視窗螢幕擷取畫面。

儀表板上顯示的資訊來自兩個來源：

  • OpenTelemetry (OTel)，這是一個開放原始碼程式庫，用於追蹤應用程式的追蹤、計量和記錄。 本文件提供 Aspire 儀表板如何與 OTel 整合的詳細資訊。

    • 追蹤會追蹤要求的生命週期 - 在應用程式的不同部分之間移動時，如何接收和處理要求。 此資訊有助於識別瓶頸和其他問題。
    • 計量是基礎結構的一般健康情況和效能的即時測量，例如，取用多少 CPU 資源，以及應用程式每秒處理的交易數目。 這項資訊有助於了解應用程式的回應性，或識別效能問題的早期警告跡象。
    • 記錄會記錄應用程式執行期間發生的所有事件和錯誤。 這項資訊適用於尋找發生問題的時間和相互關聯的事件。

  • Kubernetes API 提供應用程式執行所在基礎 Kubernetes Pod 及其記錄的相關資訊。

儀表板會受到保護，以防止未經授權的存取和修改。 若要使用儀表板，使用者必須具有「寫入」權限或更高權限，換句話說，他們必須是環境上的參與者或擁有者。

開啟儀表板

提示

雖然入口網站不失為一個選項，但啟用儀表板的建議方法是使用 azd。 如果您使用入口網站時遇到問題，請在容器應用程式 GitHub 存放庫中建立問題。

您可以使用下列步驟，在任何現有的容器應用程式上啟用 .NET Aspire 儀表板。

  1. 前往 Azure 入口網站。

  2. 開啟容器應用程式的 [概觀] 視窗。

  3. 尋找 [.NET Aspire 儀表板] 標籤，然後選取 [啟用] 連結。

    此動作會開啟 .NET Aspire 儀表板的設定視窗。

  4. 在 [.NET Aspire 儀表板] 標籤旁，選取 [已啟用] 核取方塊。

    您現在會看見 .NET Aspire 儀表板 URL。

  5. 選取儀表板的 URL。

您可以使用下列命令，在任何現有的容器應用程式環境中啟用 .NET Aspire 儀表板。

az containerapp env dotnet-component create \
  --environment <ENVIRONMENT_NAME> \
  --name <CONTAINER_APP_NAME> \
  --resource-group <RESOURCE_GROUP_NAME>

create 命令會傳回儀表板 URL，您可以在瀏覽器中開啟。

您可以使用下列步驟，在任何現有的容器應用程式上啟用 .NET Aspire 儀表板。

dotnet new aspire-starter
azd init --location westus2
azd config set aspire.dashboard on
azd up

up 命令會傳回儀表板 URL，您可以在瀏覽器中開啟。

疑難排解

如果您在啟用儀表板時遇到問題，請參閱下列項目：

  • 入口網站最多可能需要兩分鐘的時間啟動儀表板。 如果您嘗試在儀表板準備就緒之前移至儀表板，伺服器會傳回 404 或 421 錯誤。

  • 如果您遇到 421 「錯誤指示要求」錯誤，請關閉瀏覽器視窗，等候幾分鐘，然後再試一次。

  • 您存取儀表板時可能會收到驗證錯誤，內容為「無法向要求的資源驗證使用者」。

    發生此問題的原因是安全組許可權不會傳播至容器應用程式環境。 若要解決此問題，請確定您在 Container Apps 環境中明確提供 參與者 或 擁有者 角色。 這可以透過下列步驟完成：

    • 瀏覽至資源：
      • 開啟 Azure 入口網站並搜尋您的容器應用程式環境。
    • 存取 [存取控制 （IAM） 刀鋒視窗：
      • 按兩下容器應用程式環境的 存取控制 （IAM）。
    • 確認現有的角色指派：
      • 檢查您是否已指派任何角色（或您的帳戶）。 請注意，許可權目前不會透過安全組傳播。
      • 如果您不是，請遵循其餘步驟來指派角色。
    • 明確角色指派： - 按兩下 [新增 > 新增角色指派]。 - 選擇 [角色]：[參與者] 或 [擁有者]，視您的必要存取層級適當。 - 明確將角色指派給您的使用者帳戶（例如 ）。 youremail@domain.com
    • 儲存並確認：
      • 儲存變更。 請確定角色會顯示在 [角色指派] 區段底下。
    • 確認儀表板存取：
      • 嘗試存取 Aspire 儀錶板來測試。 如果您繼續收到錯誤，請連絡我們的小組。

相關內容

.NET Aspire 儀表板概觀