自动问题呈现

概览

自动问题呈现 (AIS) 提供有关在 Hybrid 集群中检测到的未解决问题的快速信息。此信息包括问题排查和解决方法文档的链接。自动问题呈现仅查找已知问题、常见问题和系统可检测的问题,无法检测集群中的所有问题。

从 Apigee Hybrid v1.10 开始,Apigee 运行时 watcher 组件会自动扫描控制平面和 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 X 和 Apigee Hybrid playbook 简介,查看 Apigee 问题排查指南的概览和列表。