自动问题呈现

概览

自动问题呈现 (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

应用配置。

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 playbook 简介，查看 Apigee 问题排查指南的概览和列表。