Application Monitoring 的拓撲圖可讓您以視覺化方式呈現應用程式、服務和工作負載之間的關係。您可以使用這張動態圖表，檢查流量、延遲時間、錯誤率和未解決的警告。如果是向 App Hub 註冊的應用程式，您可以查看單一應用程式的拓撲，或在應用程式管理邊界層級查看拓撲，瞭解應用程式如何與外部服務和工作負載互動。
如要執行自訂查詢，並將警告和流量資料與其他遙測資料建立關聯，請使用 Cloud Hub 中的 App Topology。
瞭解拓撲圖
應用程式拓撲圖完全可互動，並提供動態、實用的應用程式、服務和工作負載檢視畫面。這個檢視畫面可協助您監控及排解效能問題。
下圖顯示應用程式管理邊界的拓撲圖：
這張圖表包含下列元素：
藍色圓圈：每個藍色圓圈代表一個在 App Hub 註冊的應用程式。這個範例顯示了多個應用程式：
如果是兩個應用程式，藍色圓圈會顯示 unfold_less「Collapse」(收合) 按鈕。系統會顯示這些應用程式的服務和工作負載。
如果是單一應用程式，系統會顯示單一節點，藍色圓圈則會顯示 「Expand」按鈕。按鈕中的值是已註冊的服務和工作負載數量。
如要查看應用程式的屬性和警示資訊，請選取藍色圓圈。
節點：每個節點代表已註冊或探索到的服務或工作負載。節點圖示會顯示下列其中一項：
- 代理 ()
- MCP 伺服器 (
) - 服務 (
) - 工作負載 (
)
如要取得屬性和警告的相關資訊，請選取節點。
連線：代表兩個節點之間的流量。如要取得重要指標的資訊，例如錯誤率和第 95 個百分位數延遲時間，請選取連線：
限制
- 連線會顯示應用程式監控功能從最近一小時資料中得出的延遲時間和錯誤率資訊。您無法變更 Application Monitoring 使用的時間範圍。
- 拓撲圖和彈出式視窗只會顯示過去 24 小時內的警告。
- 對於已註冊的應用程式、服務和工作負載，拓撲圖會顯示具有資源標籤的警告政策所發出的警告，而非具有應用程式標籤的警告政策所發出的警告。針對探索到的服務和工作負載，Application Monitoring 會使用資源標籤來識別警告。
- 拓撲圖最多顯示 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 (如有尚未啟用的 API)。
啟用 API 所需的角色
如要啟用 API，您必須具備
serviceusage.services.enable權限。如果您建立了專案，可能已透過擁有者角色 (roles/owner) 取得這項權限。否則，您可以透過服務使用情形管理員角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。 -
如要取得查看應用程式拓撲所需的權限，請要求管理員授予您專案的 App Topology 檢視者 (
roles/apptopology.viewer) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。這個預先定義的角色具備查看應用程式拓撲所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：
所需權限
您必須具備下列權限，才能查看應用程式拓撲：
-
取得探索到的資源資料：
apptopology.discoveredResourcesTopologies.generate -
取得資源資料：
apptopology.sreDomainTopologies.generate
-
取得探索到的資源資料：
- 檢測應用程式以使用 OpenTelemetry，並將追蹤記錄資料傳送至 OTLP 端點。
查看應用程式管理邊界的拓撲
-
前往 Google Cloud 控制台的「Application monitoring」頁面：
前往「Application monitoring」(應用程式監控)
如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。
在 Google Cloud 控制台的專案挑選器中，選取主專案或管理專案。
按一下「Topology」分頁標籤。應用程式管理邊界的拓撲圖會隨即顯示。
在互動式拓撲圖中，您可以執行下列操作：
您可以放大或縮小、重新定位節點，或收合/展開藍色圓圈，變更圖表。
選取應用程式或節點，即可取得屬性和相關警示的資訊。
如果是探索到的服務和工作負載，彈出式視窗可能會顯示 Cloud Asset Inventory 名稱。Google Cloud Observability 會根據資產名稱，判斷資訊主頁要顯示哪些資料。
選取連線，即可取得節點之間的流量資訊。彈出式視窗會顯示節點名稱和重要指標，例如錯誤率和第 95 個百分位數的延遲時間。
查看應用程式的拓撲圖
-
前往 Google Cloud 控制台的「Application monitoring」頁面：
前往「Application monitoring」(應用程式監控)
如果您是使用搜尋列尋找這個頁面，請選取子標題為「Monitoring」的結果。
在 Google Cloud 控制台的專案挑選器中，選取主專案或管理專案。
從清單中選取應用程式。
按一下「Topology」分頁標籤。應用程式的拓撲圖隨即顯示。
在互動式拓撲圖中，您可以執行下列操作：
放大或縮小，或重新調整節點位置，即可變更圖表。
選取節點，即可取得屬性和警示的相關資訊。
選取連線，即可取得節點之間的流量資訊。彈出式視窗會顯示節點名稱和重要指標，例如錯誤率和第 95 個延遲時間百分位數。
疑難排解
如要瞭解應用程式拓撲圖未顯示資料的原因，請參閱「排解應用程式監控問題」。
後續步驟
- 在 Cloud Hub 中探索拓撲圖。