針對 VMWare Spring Cloud 閘道進行疑難排解

發行項
10/01/2024

注意

基本、標準和企業方案將從 2025 年 3 月中旬開始淘汰，並停用 3 年。建議您轉換至 Azure Container Apps。如需詳細資訊，請參閱 Azure Spring Apps 淘汰公告。

標準 耗用量和專用 方案將從 2024 年 9 月 30 日起淘汰，並在六個月後完成關閉。建議您轉換至 Azure Container Apps。如需詳細資訊，請參閱將 Azure Spring Apps 標準取用和專用方案遷移至 Azure Container Apps。

本文適用於：❌基本/標準 ✔️ Enterprise

本文說明如何使用 Azure Spring 應用程式 Enterprise 方案，針對適用於 VMware Tanzu 的 Spring Cloud 閘道進行疑難排解。若要深入了解 VMware Spring Cloud 閘道，請參閱設定 VMware Spring Cloud 閘道。

必要條件

已佈建的 Azure Spring 應用程式 Enterprise 方案服務執行個體，並且已啟用 VMWare Spring Cloud 閘道。如需詳細資訊，請參閱快速入門：使用 Enterprise 方案建置應用程式並將其部署至 Azure Spring 應用程式。
Azure CLI 2.45.0 版或更新版本。使用下列命令安裝 Azure Spring 應用程式延伸模組：az extension add --name spring。

檢查閘道計量

如需如何在 Azure 入口網站上檢查計量的詳細資訊，請參閱 Azure Spring 應用程式計量的常見計量頁面一節。

如需每個支援計量的詳細資訊，請參閱 Azure Spring 應用程式計量的閘道一節。

檢查閘道記錄

Spring Cloud 閘道是由下列子元件所組成：

spring-cloud-gateway-operator 用於管理閘道。
spring-cloud-gateway 滿足這些功能。

這兩個子元件都有可用的記錄。下列各節說明如何檢查這些記錄。

使用即時記錄串流

您可使用 Azure CLI 即時串流記錄。如需詳細資訊，請參閱即時串流 Azure Spring 應用程式受控元件記錄。下列範例說明如何使用 Azure CLI 命令，持續串流 spring-cloud-gateway 和 spring-cloud-gateway-operator 子元件的新記錄。

使用下列命令來串流 spring-cloud-gateway 的記錄：

az spring component logs \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name spring-cloud-gateway \
    --all-instances \
    --follow

使用下列命令來串流 spring-cloud-gateway-operator 的記錄：

az spring component logs \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name spring-cloud-gateway-operator \
    --all-instances \
    --follow

使用 Log Analytics

下列各節說明如何使用 Log Analytics 檢視系統記錄。

Log Analytics 的診斷設定

您必須先開啟系統記錄並傳送至 Log Analytics，才能查詢 VMware Spring Cloud 閘道的記錄。若要在 Azure 入口網站中啟用系統記錄，請使用下列步驟：

開啟您的 Azure Spring 應用程式執行個體。
在導覽功能表中，選取 [診斷設定]。
選取 [新增診斷設定]，或針對現有設定選取 [編輯設定]。
在 [記錄] 區段中，選取 [系統記錄] 類別。
在 [目的地詳細資料] 區段中，選取 [傳送至 Log Analytics 工作區]，然後選取您的工作區。
選取 [儲存] 以更新設定。

檢查 Log Analytics 中的記錄

若要使用 Azure 入口網站檢查 spring-cloud-gateway 和 spring-cloud-gateway-operator 的記錄，請使用下列步驟：

確定您已開啟 [系統記錄]。如需詳細資訊，請參閱 Log Analytics 的診斷設定一節。
開啟您的 Azure Spring 應用程式執行個體。
在瀏覽窗格中選取 [記錄]，然後選取 [概觀]。

在查詢編輯窗格中使用下列範例查詢。調整時間範圍，然後選取 [執行] 以搜尋記錄。

若要檢視 spring-cloud-gateway 的記錄，請使用下列查詢：

AppPlatformSystemLogs
| where LogType in ("SpringCloudGateway")
| project TimeGenerated , ServiceName , LogType, Log , _ResourceId
| limit 100

若要檢視 spring-cloud-gateway-operator 的記錄，請使用下列查詢：

AppPlatformSystemLogs
| where LogType in ("SpringCloudGatewayOperator")
| project TimeGenerated , ServiceName , LogType, Log , _ResourceId
| limit 100

注意

在 Log Analytics 中提供記錄之前，可能有幾分鐘的延遲。

調整記錄層級

本節說明如何調整 VMware Spring Cloud 閘道的記錄層級，並提供一個記錄器作為範例。

重要

開始之前，務必閱讀設定 VMware Spring Cloud 閘道的設定記錄層級一節，以瞭解調整記錄層級的詳細資料和影響。

使用下列步驟來調整記錄層級：

在 Azure Spring 應用程式執行個體中，選取瀏覽窗格中的 [Spring Cloud 閘道]，然後選取 [設定]。
在 [屬性] 區段中，填入索引鍵/值組 logging.level.org.springframework.cloud.gateway=DEBUG。
選取儲存以儲存變更。
變更成功之後，您可找到更詳細的疑難排解記錄，例如如何路由傳送要求的相關資訊。

設定警示規則

您可以根據記錄和計量建立警示規則。如需詳細資訊，請參閱建立或編輯計量警示規則。

使用下列步驟，直接從 Azure 入口網站建立 Azure Spring 應用程式的警示規則：

開啟您的 Azure Spring 應用程式執行個體。
瀏覽至 [記錄] 或 [計量]。
在 [記錄] 窗格中寫入記錄查詢，或新增計量圖表。
選取 [新增警示規則]。此動作會帶您前往 [建立警示規則] 窗格，並自動填妥記錄查詢或計量。

您現在可以設定警示規則詳細資料。

使用應用程式效能監視器監視閘道

如需支援的應用程式效能監視器及其設定方式的詳細資訊，請參閱設定 VMware Spring Cloud 閘道的設定應用程式效能監視一節。

重新啟動閘道

對於某些錯誤，重新啟動可能有助於解決問題。如需詳細資訊，請參閱設定 VMware Spring Cloud 閘道的重新啟動 Spring Cloud 閘道一節。

共用方式為