Automatisierte Problemsuche

Übersicht

Automatisierte Problemsuche (AIS) bietet schnelle Informationen zu aktuellen Problemen, die in Ihrem Hybridcluster erkannt wurden. Diese Informationen enthalten Links zur Dokumentation für die Fehlersuche und -behebung. Die automatische Problemsuche sucht nur nach bekannten, allgemeinen, vom System erkennbaren Problemen und kann nicht alle Probleme innerhalb eines Clusters erkennen.

Ab Apigee Hybrid v1.10 scannt die Apigee-Laufzeit-Watcher-Komponente die Steuerungsebene und den Kubernetes API-Serverstatus automatisch, um festzustellen, ob Konfigurationsprobleme vorliegen. Standardmäßig wird der Scan alle 60 Sekunden ausgeführt. Sie können das Intervall ändern oder den Scan deaktivieren.

Wenn AIS ein Problem erkennt, wird eine neue Instanz von ApigeeIssue auf dem Kubernetes API-Server erstellt. Diese Instanzen enthalten Informationen über die Probleme und Links zur Dokumentation über die bestimmten Probleme.

Wenn Sie Probleme beheben, werden sie automatisch vom Kubernetes-API-Server gelöscht, sobald der Scan feststellt, dass sie nicht mehr auftreten.

Automatische Problemsuche verwenden.

Suchen Sie mit dem Befehl kubectl get apigeeissues nach vorhandenen Problemen:

kubectl -n APIGEE_NAMESPACE get apigeeissues

Beispiel:

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

Verwenden Sie den Befehl kubectl describe mit dem Problemnamen, um ausführlichere Informationen zu einem bestimmten Problem zu erhalten. Dem Namen muss apigeeissues/ vorangestellt werden. Beispiel: 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: 

Scanintervall ändern

Standardmäßig scannt Watcher alle 60 Sekunden die Steuerungsebene auf Probleme. Wenn Sie das Scanintervall ändern möchten, geben Sie das neue Intervall in Sekunden mit dem Attribut watcher.args.issueScanInterval in Ihrer Überschreibungendatei an. Beispiel:

watcher:
  args:
    issueScanInterval: 120

Wenden Sie die Konfiguration an.

Aktualisieren Sie die apigee-env-Diagramme für die einzelnen Apigee-Umgebung.

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

Automatische Problemsuche deaktivieren

Sie können die automatische Problemsuche deaktivieren. Setzen Sie dazu das Attribut watcher.args.enableIssueScanning in Ihrer Überschreibungsdatei auf false. Beispiel:

watcher:
  args:
    enableIssueScanning: false

Wenden Sie die Konfiguration an.

Aktualisieren Sie die apigee-env-Diagramme für die einzelnen Apigee-Umgebung.

helm upgrade $ORG_NAME apigee-org/ \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE 
Die automatische Problemsuche kann direkte Links zu den Anleitungen zur Fehlerbehebung bereitstellen, einschließlich: Weitere Informationen und Anleitungen zur Fehlerbehebung finden Sie unter Einführung in Playbooks für Apigee X und Apigee Hybrid.