Identification automatique des problèmes

Présentation

L'identification automatique des problèmes (Automated issue surfacing ou AIS) fournit des informations rapides sur les problèmes en cours détectés au sein de votre cluster Hybrid. Ces informations incluent des liens vers de la documentation dédiée au dépannage et à la résolution. L'identification automatique des problèmes ne recherche que les problèmes connus, courants et détectables par le système, et ne peut pas détecter l'intégralité des problèmes d'un cluster.

À partir de la version 1.10 d'Apigee hybrid, le composant d'observation de l'environnement d'exécution Apigee analyse automatiquement l'état du plan de contrôle et du serveur d'API Kubernetes pour déterminer s'il existe des problèmes de configuration. Par défaut, l'analyse a lieu toutes les 60 secondes. Vous pouvez modifier l'intervalle ou désactiver l'analyse si vous le souhaitez.

Lorsque le service AIS détecte un problème, il crée une nouvelle instance d'ApigeeIssue sur le serveur d'API Kubernetes. Ces instances contiennent des informations sur les problèmes spécifiques, ainsi que des liens vers la documentation associée.

Lorsque vous résolvez un problème, celui-ci est automatiquement supprimé du serveur d'API Kubernetes une fois que l'analyse a déterminé qu'il ne se produit plus.

Utiliser l'identification automatique des problèmes

Vérifiez s'il existe des problèmes à l'aide de la commande kubectl get apigeeissues : 

kubectl -n APIGEE_NAMESPACE get apigeeissues

Exemple :

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

Pour obtenir des informations plus détaillées sur un problème spécifique, exécutez la commande kubectl describe avec le nom du problème. Ce nom doit être précédé de apigeeissues (par exemple, 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:

Modifier l'intervalle d'analyse

Par défaut, le composant d'observation analyse le plan de contrôle pour détecter les problèmes toutes les 60 secondes. Pour modifier l'intervalle d'analyse, spécifiez le nouvel intervalle en secondes à l'aide de la propriété watcher.args.issueScanInterval dans votre fichier de remplacement. Exemple :

watcher:
  args:
    issueScanInterval: 120

Appliquez la configuration.

Helm

Mettez à niveau le chart apigee-env pour chaque environnement Apigee.

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

apigeectl

Appliquez la modification à tous les environnements.

apigeectl apply -f OVERRIDES_FILE --org

Désactiver l'identification automatique des problèmes

Vous pouvez désactiver l'identification automatique des problèmes en définissant la propriété watcher.args.enableIssueScanning sur false dans votre fichier de remplacement. Exemple :

watcher:
  args:
    enableIssueScanning: false

Appliquez la configuration.

Helm

Mettez à niveau le chart apigee-env pour chaque environnement Apigee.

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

apigeectl

Appliquez la modification à tous les environnements.

apigeectl apply -f OVERRIDES_FILE --org
L'identification automatique des problèmes peut fournir des liens vers les guides de dépannage, y compris : Consultez la page Présentation des playbooks Apigee et Apigee hybrid pour obtenir une présentation et une liste des guides de dépannage Apigee.