Presentación automática de problemas

Descripción general

Los problemas automatizados (AIS) proporcionan información rápida sobre los problemas en curso detectados en el clúster híbrido. Esta información incluye vínculos a la documentación para solucionar problemas y resolver la resolución. El problema automatizado que aparece solo busca problemas conocidos, comunes y detectables del sistema, y no puede detectar todos los problemas dentro de un clúster.

A partir de Apigee Hybrid v1.10, el componente del agente de observación del entorno 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 el análisis.

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

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

Usar el descubrimiento automático de problemas.

Verifica si hay problemas existentes 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 específico, usa el comando kubectl describe con el nombre del problema. El nombre debe ir precedido por 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:

Cambia el intervalo de análisis

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

watcher:
  args:
    issueScanInterval: 120

Aplica la configuración.

Helm

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

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

apigeectl

Aplica el cambio a todos los entornos.

apigeectl apply -f OVERRIDES_FILE --org

Inhabilita el envío automático de problemas

Puedes inhabilitar el problema automático que aparece cuando configuras la propiedad watcher.args.enableIssueScanning en false en tu archivo de anulación. Por ejemplo:

watcher:
  args:
    enableIssueScanning: false

Aplica la configuración.

Helm

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

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

apigeectl

Aplica el cambio a todos los entornos.

apigeectl apply -f OVERRIDES_FILE --org
Los problemas automatizados aparecen de forma directa en las guías de solución de problemas, incluidas las siguientes:Consulta Introducción a las guías de Apigee X y Apigee Hybrid para obtener una descripción general y una lista de guías de solución de problemas de Apigee.