自動顯示問題

總覽

自動顯示問題 (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 套用設定。

自動顯示問題功能可直接提供疑難排解指南的連結,包括: 如需 Apigee 疑難排解指南的總覽和清單,請參閱「Apigee X 和 Apigee Hybrid 教戰手冊簡介」。