總覽
自動顯示問題 (AIS) 功能可快速提供 Hybrid 叢集偵測到的持續性問題資訊。這類資訊包括疑難排解和解決問題的文件連結。自動顯示問題功能只會尋找已知、常見、系統可偵測到的問題,無法偵測叢集中的所有問題。
從 Apigee Hybrid 1.10 版開始,Apigee 執行階段監控器元件會自動掃描控制層和 Kubernetes API 伺服器狀態,判斷是否有任何設定問題。根據預設,掃描作業每 60 秒會執行一次。您可以變更間隔或停用掃描功能。
當 AIS 偵測到問題時,會在 Kubernetes API 伺服器中建立新的 ApigeeIssue 執行個體。這些執行個體包含問題相關資訊,以及特定問題的文件連結。
解決問題後,掃描作業判斷問題不再發生時,系統就會自動從 Kubernetes API 伺服器刪除問題。
使用自動顯示問題功能。
使用 kubectl get apigeeissues 指令檢查是否有任何現有問題:
kubectl -n APIGEE_NAMESPACE get apigeeissues
例如:
kubectl -n APIGEE_NAMESPACE get apigeeissues NAME SEVERITY AGE URL vhost-missing-eg-nonprod Error 1hr https://cloud.google.com/apigee/docs/hybrid/MISSING_ENV_GROUP control-plane-connectivity-failure Error 1d https://cloud.google.com/apigee/docs/hybrid/OLD_TLS_VERSION
如要進一步瞭解特定問題,請使用 kubectl describe 指令,並提供問題名稱。名稱前面必須加上 apigeeissues,例如:
apigeeissues vhost-missing-eg-nonprod。
kubectl -n APIGEE_NAMESPACE describe apigeeissues vhost-missing-eg-nonprod Name: vhost-missing-eg-nonprod Namespace: apigee Labels:Annotations: API Version: apigee.cloud.google.com/v1alpha1 Kind: ApigeeIssue Metadata: Creation Timestamp: 2022-08-25T20:41:56Z Managed Fields: API Version: apigee.cloud.google.com/v3 Resource Version: 12345678 UID: aaaaaaaa-bbbb-cccc-dddd-eeeeffffgggg Spec: Severity: Error Reason: MISSING_ENV_GROUP Details: Expected envgroup "nonprod" for ApigeeRouteConfig "my-org-nonprod" Documentation: https://cloud.google.com/apigee/docs/hybrid/MISSING_ENV_GROUP Ignore: false IgnoreReason: Events:
變更掃描間隔
根據預設,Watcher 每 60 秒會掃描一次控制層,找出問題。如要變更掃描間隔,請在覆寫檔案中,使用 watcher.args.issueScanInterval 屬性指定新的間隔 (以秒為單位)。例如:
watcher:
args:
issueScanInterval: 120
使用 apigeectl apply -f OVERRIDES_FILE --org 套用設定。
停用自動顯示問題功能
如要停用自動顯示問題功能,請在覆寫檔案中將 watcher.args.enableIssueScanning 屬性設為 false。例如:
watcher:
args:
enableIssueScanning: false
使用 apigeectl apply -f OVERRIDES_FILE --org 套用設定。