自動顯示問題

總覽

自動顯示問題 (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

套用設定。

Helm

為每個 Apigee 環境升級 apigee-env 圖表。

helm upgrade $ORG_NAME apigee-org/ \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE

apigeectl

將變更套用至所有環境。

apigeectl apply -f OVERRIDES_FILE --org

停用自動顯示問題功能

如要停用自動顯示問題功能，請在覆寫檔案中將 watcher.args.enableIssueScanning 屬性設為 false。例如：

watcher:
  args:
    enableIssueScanning: false

套用設定。

Helm

為每個 Apigee 環境升級 apigee-env 圖表。

helm upgrade $ORG_NAME apigee-org/ \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE

apigeectl

將變更套用至所有環境。

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