查看應用程式拓撲

本文說明如何查看 Application Monitoring 為 App Hub 應用程式、服務和工作負載建立的拓撲地圖。應用程式拓撲地圖會動態顯示應用程式的關係,協助您監控快訊和流量,以及排解問題。

瞭解拓撲地圖

應用程式拓撲地圖會動態顯示應用程式效能,方便您監控及排解問題。拓撲地圖會使用節點和邊緣表示應用程式,如下所示:

  • 節點代表應用程式的服務和工作負載:

    範例應用程式的拓撲。

  • 邊緣代表應用程式在服務和工作負載之間的流量:

    邊緣會顯示延遲時間和錯誤率。

拓撲地圖完全是互動式,您可以放大及縮小,並移動節點,以便將服務和工作負載之間的關係視覺化。如要開啟面板,查看特定節點或邊緣的狀態詳細資料,請按一下節點或邊緣。

事前準備

如要產生應用程式拓撲地圖,追蹤資料必須包含應用程式專屬標籤。只有在您使用 OpenTelemetry 檢測應用程式、將追蹤資料傳送至 Telemetry API,以及向應用程式中心註冊應用程式時,才能使用這些標籤。

如要開始使用,請按照下列步驟操作:

  1. 按照「設定應用程式監控」一文的說明,設定應用程式監控。 設定應用程式監控功能時,請設定預設追蹤記錄範圍,列出所有儲存追蹤記錄資料的專案
  2. 如果您使用已啟用應用程式的資料夾,專案會預設採用服務使用限制政策,禁止您使用 App Topology API。如要解決這個問題,請由具備機構政策管理員角色的使用者,將 apptopology.googleapis.com 新增至啟用應用程式的資料夾管理專案政策允許清單。請注意,機構層級也可能設有政策。 詳情請參閱「限制資源用量」。
  3. Enable the Observability, App Topology, and Telemetry APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

    如果您已將其他專案新增至追蹤範圍,建議您也為這些專案啟用 Observability API。 應用程式拓撲地圖只會顯示追蹤範圍專案的追蹤邊緣,這些專案必須與 App Hub 專案位於相同機構。
  4. 如要取得查看應用程式拓撲所需的權限,請要求管理員授予您專案的應用程式拓撲檢視者 (roles/apptopology.viewer) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

    這個預先定義的角色具備查看應用程式拓撲所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:

    所需權限

    如要查看應用程式拓撲,必須具備下列權限:

    • 如要產生拓撲: apptopology.applicationTopologies.generate

    您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

  5. 檢測應用程式以使用 OpenTelemetry,並將追蹤記錄資料傳送至 OTLP 端點

查看拓撲地圖

  1. 前往 Google Cloud 控制台的「Application monitoring」(應用程式監控) 頁面:

    前往「應用程式監控」

    如果您是使用搜尋列尋找這個頁面,請選取子標題為「Monitoring」的結果

  2. 在 Google Cloud 控制台的專案選擇工具中,選取 App Hub 主專案或管理專案。

  3. 從清單中選取應用程式。

  4. 按一下「拓撲」分頁標籤。畫面上會顯示應用程式的拓撲地圖。

拓撲地圖完全是互動式,您可以放大及縮小,並移動節點,以便將服務和工作負載之間的關係視覺化。您也可以查看節點或邊緣的詳細資料:

  • 如要查看服務或工作負載的未解決警報或屬性,請選取節點。
  • 如要查看兩個節點之間的延遲和錯誤率,請選取邊緣。

疑難排解

如需有助於瞭解應用程式拓撲地圖未顯示資料的原因,請參閱「排解應用程式監控問題」。