自動顯示問題

總覽

自動顯示問題 (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 X 和 Apigee Hybrid 教戰手冊簡介」，瞭解 Apigee 疑難排解指南的概略說明和清單。