Ü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
Zugehörige Anleitungen zur Fehlerbehebung
Die automatische Problemsuche kann direkte Links zu den Anleitungen zur Fehlerbehebung bereitstellen, einschließlich:- Keine Netzwerkverbindung zwischen Laufzeitebene und Steuerungsebene
- Virtueller Host ohne Umgebungsgruppe
- Virtueller Host fehlt Selektor
- Abweichendes Ingress-Zertifikat
- Ablauf des Ingress-Zertifikats
- Ablauf des mTLS-CA-Zertifikats für eingehenden Traffic
- Ingress-mTLS-CA-Zertifikat ungültig