Detección automática de problemas

Información general

La detección automática de problemas (AIS) proporciona información rápida sobre los problemas que se detectan en tu clúster híbrido. Esta información incluye enlaces a documentación para solucionar problemas. La detección automática de problemas solo busca problemas conocidos, habituales y detectables por el sistema, y no puede detectar todos los problemas de un clúster.

A partir de Apigee Hybrid v1.10, el componente de monitorización del tiempo de ejecución de Apigee analiza automáticamente el plano de control y el estado del servidor de la API de Kubernetes para determinar si hay algún problema de configuración. De forma predeterminada, el análisis se realiza cada 60 segundos. Si lo prefieres, puedes cambiar el intervalo o inhabilitar la búsqueda.

Cuando AIS detecta un problema, crea una instancia nueva de ApigeeIssue en el servidor de la API de Kubernetes. Estas instancias contienen información sobre los problemas y enlaces a documentación sobre los problemas específicos.

Cuando resuelvas los problemas, se eliminarán automáticamente del servidor de la API de Kubernetes cuando el análisis determine que ya no se producen.

Usar la detección automática de problemas.

Comprueba si hay algún problema con el comando kubectl get apigeeissues: 

kubectl -n APIGEE_NAMESPACE get apigeeissues

Por ejemplo:

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

Para obtener información más detallada sobre un problema concreto, usa el comando kubectl describe con el nombre del problema. El nombre debe ir precedido de apigeeissues/. Por ejemplo: 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:

Cambiar el intervalo de análisis

De forma predeterminada, Watcher analiza el plano de control en busca de problemas una vez cada 60 segundos. Para cambiar el intervalo de análisis, especifica el nuevo intervalo en segundos con la propiedad watcher.args.issueScanInterval en el archivo de anulaciones. Por ejemplo:

watcher:
  args:
    issueScanInterval: 120

Aplica la configuración.

Actualiza el gráfico apigee-env de cada entorno de Apigee.

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

Inhabilitar la detección automática de problemas

Para inhabilitar la detección automática de problemas, defina la propiedad watcher.args.enableIssueScanning en false en el archivo de anulaciones. Por ejemplo:

watcher:
  args:
    enableIssueScanning: false

Aplica la configuración.

Actualiza el gráfico apigee-env de cada entorno de Apigee.

helm upgrade $ORG_NAME apigee-org/ \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE
La detección automática de problemas puede proporcionar enlaces directos a las guías de solución de problemas, como las siguientes: Consulta la introducción a los manuales de Apigee X y Apigee Hybrid para ver una descripción general y una lista de las guías para solucionar problemas de Apigee.