Automatisierte Problemsuche

Überblick

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 get apigeeissues

Beispiel:

kubectl -n apigee 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 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.

Helm

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

helm upgrade ENV_NAME apigee-env/ \
  --install \
  --namespace NAMESPACE \
  --set env=ENV_NAME \
  --atomic \
  -f overrides.yaml

apigeectl

Wenden Sie die Änderung auf alle Umgebungen an.

apigeectl apply -f overrides --all-envs

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.

Helm

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

helm upgrade ENV_NAME apigee-env/ \
  --install \
  --namespace NAMESPACE \
  --set env=ENV_NAME \
  --atomic \
  -f overrides.yaml

apigeectl

Wenden Sie die Änderung auf alle Umgebungen an.

apigeectl apply -f overrides --all-envs
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.