本文說明如何查看 Application Monitoring 為 App Hub 應用程式、服務和工作負載建立的拓撲地圖。應用程式拓撲地圖會動態顯示應用程式的關係,協助您監控快訊和流量,以及排解問題。
瞭解拓撲地圖
應用程式拓撲地圖會動態顯示應用程式效能,方便您監控及排解問題。拓撲地圖會使用節點和邊緣表示應用程式,如下所示:
節點代表應用程式的服務和工作負載:
邊緣代表應用程式在服務和工作負載之間的流量:
拓撲地圖完全是互動式,您可以放大及縮小,並移動節點,以便將服務和工作負載之間的關係視覺化。如要開啟面板,查看特定節點或邊緣的狀態詳細資料,請按一下節點或邊緣。
事前準備
如要產生應用程式拓撲地圖,追蹤資料必須包含應用程式專屬標籤。只有在您使用 OpenTelemetry 檢測應用程式、將追蹤資料傳送至 Telemetry API,以及向應用程式中心註冊應用程式時,才能使用這些標籤。
如要開始使用,請按照下列步驟操作:
- 按照「設定應用程式監控」一文的說明,設定應用程式監控。 設定應用程式監控功能時,請設定預設追蹤記錄範圍,列出所有儲存追蹤記錄資料的專案。
- 如果您使用已啟用應用程式的資料夾,專案會預設採用服務使用限制政策,禁止您使用 App Topology API。如要解決這個問題,請由具備機構政策管理員角色的使用者,將
apptopology.googleapis.com新增至啟用應用程式的資料夾管理專案政策允許清單。請注意,機構層級也可能設有政策。 詳情請參閱「限制資源用量」。 -
Enable the Observability, App Topology, and Telemetry APIs.
如果您已將其他專案新增至追蹤範圍,建議您也為這些專案啟用 Observability API。 應用程式拓撲地圖只會顯示追蹤範圍專案的追蹤邊緣,這些專案必須與 App Hub 專案位於相同機構。Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant roles. -
如要取得查看應用程式拓撲所需的權限,請要求管理員授予您專案的應用程式拓撲檢視者 (
roles/apptopology.viewer) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。這個預先定義的角色具備查看應用程式拓撲所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:
所需權限
如要查看應用程式拓撲,必須具備下列權限:
-
如要產生拓撲:
apptopology.applicationTopologies.generate
-
如要產生拓撲:
- 檢測應用程式以使用 OpenTelemetry,並將追蹤記錄資料傳送至 OTLP 端點。
查看拓撲地圖
-
前往 Google Cloud 控制台的「Application monitoring」(應用程式監控) 頁面:
如果您是使用搜尋列尋找這個頁面,請選取子標題為「Monitoring」的結果。
在 Google Cloud 控制台的專案選擇工具中,選取 App Hub 主專案或管理專案。
從清單中選取應用程式。
按一下「拓撲」分頁標籤。畫面上會顯示應用程式的拓撲地圖。
拓撲地圖完全是互動式,您可以放大及縮小,並移動節點,以便將服務和工作負載之間的關係視覺化。您也可以查看節點或邊緣的詳細資料:
- 如要查看服務或工作負載的未解決警報或屬性,請選取節點。
- 如要查看兩個節點之間的延遲和錯誤率,請選取邊緣。
疑難排解
如需有助於瞭解應用程式拓撲地圖未顯示資料的原因,請參閱「排解應用程式監控問題」。