如要瞭解應用程式、服務和工作負載之間的關係,請查看拓撲圖。這張動態圖表可協助您瞭解流量,並找出事件。如要查看透過 App Hub 註冊的應用程式拓撲,請前往應用程式層級。您也可以在應用程式管理邊界層級查看拓撲圖,瞭解應用程式與外部服務和工作負載的互動方式。
如要進一步探索應用程式,可以在 Cloud Hub 中使用「App Topology」。您可以建立自訂查詢,並將警示和流量資料與其他資料建立關聯。
瞭解拓撲圖
應用程式拓撲圖是全互動式圖表,可動態顯示應用程式、服務和工作負載的實用檢視畫面。這個檢視畫面可協助您監控及排解效能問題。
下圖顯示應用程式管理邊界的拓撲圖:

這個圖表包含下列元素:
藍色圓圈:每個藍色圓圈代表向應用程式中心註冊的應用程式。這個範例顯示了幾項應用程式:
如果是兩個應用程式,藍色圓圈會顯示「收合」unfold_less按鈕。這些應用程式會顯示服務和工作負載。
針對一個應用程式,系統會顯示單一節點,藍色圓圈則會顯示 「展開」按鈕。按鈕中的值是已註冊的服務和工作負載數量。
如要取得應用程式的屬性和事件資訊,請選取藍色圓圈。
節點:每個節點代表已註冊或找到的服務或工作負載。節點圖示會顯示下列其中一個圖示:
- 服務專員 ()
- MCP 伺服器 (
) - 服務 (
) - 工作負載 (
)
如要取得屬性和事件的相關資訊,請選取節點。
連線:代表兩個節點之間的流量。如要取得主要指標的相關資訊,例如錯誤率和第 95 個延遲百分位數,請選取連線:
限制
- 連線會顯示延遲時間和錯誤率資訊,這些資訊是應用程式監控服務從最近一小時的資料中衍生而來。您無法變更應用程式監控功能使用的時間範圍。
- 彈出式視窗只會顯示過去 24 小時的事件:
- 對於已註冊的應用程式、服務和工作負載,拓撲圖只會顯示含有應用程式標籤的警告政策所觸發的事件。對於探索到的服務和工作負載,應用程式監控功能會使用資源標籤來識別事件。
- 拓撲圖最多可顯示 1000 個節點或連線。針對每個支援的 App Hub 區域,圖表最多會顯示 100 項探索到的服務和 100 項探索到的工作負載。
- 您無法將對應節點拖曳到應用程式的藍色圓圈中,藉此向應用程式註冊服務或工作負載。圓圈是視覺輔助工具,不是容器。
如果下列資源的對應服務或工作負載具有 App Hub 註冊狀態
discovered,拓撲圖只會顯示連線:- Firestore 資源
- Spanner 資源
- Cloud Storage 資源
- Google Cloud MCP 伺服器
如果服務或工作負載屬於應用程式管理邊界,但未向任何應用程式註冊,註冊狀態就會是
discovered。
事前準備
如要產生應用程式的拓撲圖,追蹤資料必須包含應用程式專屬標籤。只有在您使用 OpenTelemetry 檢測應用程式、將追蹤資料傳送至 Telemetry API,以及向 App Hub 註冊應用程式時,才能使用這些標籤。
如要開始使用,請按照下列步驟操作:
- 如要設定應用程式監控,請參閱「設定應用程式監控」。設定應用程式監控功能時,請設定預設追蹤記錄範圍,列出所有儲存追蹤記錄資料的專案。
-
啟用 Observability、App Topology、Cloud Trace 和 Telemetry API。
如果您已將其他專案加入追蹤範圍,建議您也為這些專案啟用 Observability API。應用程式拓撲圖只會顯示與 App Hub 專案位於相同機構的追蹤範圍專案中的追蹤連線。啟用 API 時所需的角色
如要啟用 API,您需要服務使用情形管理員 IAM 角色 (
roles/serviceusage.serviceUsageAdmin),其中包含serviceusage.services.enable權限。瞭解如何授予角色。 -
如要取得查看應用程式拓撲所需的權限,請要求管理員授予您專案的「App Topology viewer 」(
roles/apptopology.viewer) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。這個預先定義的角色具備查看應用程式拓撲所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:
所需權限
如要查看應用程式拓撲,必須具備下列權限:
-
如要產生拓撲:
apptopology.applicationTopologies.generate
-
如要產生拓撲:
- 檢測應用程式以使用 OpenTelemetry,並將追蹤記錄資料傳送至 OTLP 端點。
查看應用程式管理邊界的拓撲
-
前往 Google Cloud 控制台的「Application monitoring」頁面:
如果您是使用搜尋列尋找這個頁面,請選取子標題為「Monitoring」的結果。
在 Google Cloud 控制台的專案選擇工具中,選取 App Hub 主專案或管理專案。
按一下「拓撲」分頁標籤。畫面上會顯示應用程式的拓撲圖。
在互動式拓撲圖中,您可以執行下列操作:
如要變更視覺化效果,請放大/縮小、重新放置節點,或收合/展開藍色圓圈。
選取應用程式或節點,即可取得屬性和相關事件的資訊。
對於探索到的服務和工作負載,飛出式視窗可能會顯示 Cloud Asset Inventory 名稱。Google Cloud Observability 會使用資產名稱,判斷要在資訊主頁上顯示哪些資料。
選取連線,即可取得節點間的流量資訊。飛出式視窗會顯示節點名稱和主要指標,例如錯誤率和第 95 個延遲百分位數。
查看應用程式的拓撲圖
-
前往 Google Cloud 控制台的「Application monitoring」頁面:
如果您是使用搜尋列尋找這個頁面,請選取子標題為「Monitoring」的結果。
在 Google Cloud 控制台的專案選擇工具中,選取 App Hub 主專案或管理專案。
從清單中選取應用程式。
按一下「拓撲」分頁標籤。畫面上會顯示應用程式的拓撲圖。
在互動式拓撲圖中,您可以執行下列操作:
縮放或重新放置節點,即可變更視覺化效果。
選取節點即可取得屬性和事件資訊。
選取連線,即可取得節點間的流量資訊。飛出式視窗會顯示節點名稱和主要指標,例如錯誤率和第 95 個延遲百分位數。
疑難排解
如要瞭解應用程式拓撲圖未顯示資料的原因,請參閱「排解應用程式監控問題」。
後續步驟
- 在 Cloud Hub 中探索拓撲圖。