Diese Seite gilt für Apigee und Apigee Hybrid.
Apigee Edge-Dokumentation aufrufen
Symptome
Bereitstellungen von API-Proxys oder freigegebenen Abläufen schlagen in der Apigee Hybrid-Benutzeroberfläche mit dem Fehler Instance INSTANCE_NAME
is not reporting status for environment group ENV_GROUP_NAME fehl.
Fehlermeldungen
Der Fehler The Instance INSTANCE_NAME is not reporting status for environment group
ENV_GROUP_NAME wird im Menü API-Proxys auf dem Tab Übersicht angezeigt, wenn Sie den Mauszeiger auf das rote Ausrufezeichen bewegen, das in der Status-Spalte im Bereich Bereitstellungen angezeigt wird:
Mögliche Ursachen
| Ursache | Beschreibung |
|---|---|
Der Selector app: apigee-ingressgateway fehlt. |
Wenn Sie den Apigee-Ingress verwenden, muss die Datei overrides.yaml im Abschnitt virtualhosts den Selector app: apigee-ingressgateway enthalten. |
Veraltete ApigeeRoute oder Umgebung, die nur auf der Steuerungsebene gelöscht wurde |
Eine Umgebung oder Bereitstellung wurde aus der Steuerungsebene oder dem Cluster entfernt, ohne den vollständigen Löschworkflow abzuschließen. Dadurch verbleiben veraltete ApigeeRoute- oder Umgebungsressourcen im Cluster. |
| Blockierter ausgehender Netzwerktraffic zu Google APIs | Cluster-Worker-Knoten können keine ausgehenden Verbindungen zu Google-Authentifizierungs- und Apigee-Steuerungsebenen-APIs auf *.googleapis.com:443 herstellen. |
| Ingress-Gateway oder Laufzeit-Pods sind nicht bereit | Die apigee-ingressgateway-Pods werden nicht mit allen Containern ausgeführt (2/2) oder apigee-runtime-Pods sind aufgrund einer fehlgeschlagenen READINESS:VersionLoadProbe-Prüfung nicht bereit (0/1). |
Ursache: Der Selector app: apigee-ingressgateway fehlt
Wenn Sie das Apigee-Ingress-Gateway verwenden, enthält die Datei overrides.yaml einen Abschnitt für die virtualhosts-Konfiguration, in dem der Selector app: apigee-ingressgateway konfiguriert werden muss.
Diagnose
Prüfen Sie zuerst, ob Sie das Apigee-Ingress-Gateway verwenden, das mit der Hybrid-Version 1.8 und höher verfügbar ist. Die folgende Konfiguration funktioniert nicht für vom Kunden verwaltetes Istio ASM. Suchen Sie in der Datei overrides.yaml, die die im Fehler erwähnte Umgebungsgruppe enthält, den Abschnitt virtualhosts und prüfen Sie, ob die folgenden Selectors fehlen:
selector:
app: apigee-ingressgateway
ingress_name: INGRESS_NAMELösung
Bearbeiten Sie die Datei overrides.yaml so, dass der Abschnitt virtualhosts[].selector in etwa so aussieht:
virtualhosts:
- name: my-environment-group
sslCertPath: my-cert.crt
sslKeyPath: my-cert.key
selector:
app: apigee-ingressgateway
ingress_name: INGRESS_NAME
Nachdem Sie die Datei overrides.yaml bearbeitet haben, wenden Sie die neue Konfiguration mit Helm an:
Probelauf:
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \ --namespace APIGEE_NAMESPACE \ --atomic \ --set envgroup=ENV_GROUP \ -f OVERRIDES_FILE \ --dry-run=server
Achten Sie darauf, alle angezeigten Einstellungen anzugeben, einschließlich --atomic, damit die Aktion bei einem Fehler rückgängig gemacht wird.
Ihre Installation wurde möglicherweise mit einem ENV_GROUP_RELEASE_NAME eingerichtet, der sich von ENV_GROUP unterscheidet. Informationen zu den Einstellungen finden Sie unter Apigee Hybrid mit Helm installieren.
Installation des Diagramms:
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \ --namespace APIGEE_NAMESPACE \ --atomic \ --set envgroup=ENV_GROUP \ -f OVERRIDES_FILE
Ursache: Veraltete ApigeeRoute oder Umgebung nur auf der Steuerungsebene gelöscht
Wenn ein Umgebungs- oder Laufzeit-Deployment aus der Steuerungsebene oder dem Cluster entfernt wird, ohne dass der vollständige Löschvorgang abgeschlossen wurde, können veraltete ApigeeRoute- oder Umgebungsressourcen im Cluster verbleiben. Wenn apigee-watcher versucht, das Routing für die Umgebungsgruppe abzugleichen, und ein fehlender Kubernetes-Dienst, ein fehlendes Deployment oder eine fehlende Umgebung der Steuerungsebene erkannt wird, kann die Routenaktualisierung nicht abgeschlossen oder der Deployment-Status nicht an die Steuerungsebene gemeldet werden.
Diagnose
-
Prüfen Sie die
apigee-watcher-Pod-Logs auf Fehler im Zusammenhang mit fehlenden Diensten oder Umgebungen:kubectl logs -n APIGEE_NAMESPACE -l app=apigee-watcher --since=2h
Suchen Sie nach Logeinträgen wie den folgenden:
-
Ein veralteter
ApigeeRouteverweist auf einen gelöschten Laufzeitdienst oder ein gelöschtes Deployment:{"level":"error","caller":"watcher/watcher.go:60","msg":"error during watch","name":"ingressstatus","error":"INTERNAL: NOT_FOUND: failed to get service: services \"apigee-runtime-ORG_ENV_HASH\" not found"}
-
Eine Umgebung wurde auf der Steuerungsebene gelöscht, während die Laufzeitressourcen im Cluster verbleiben:
{"level":"error","caller":"watcher/watcher.go:60","msg":"error during watch","name":"ingress","error":"INVALID_ARGUMENT: err fetching environment data: NOT_FOUND: {\n \"error\": {\n \"code\": 404,\n \"message\": \"generic::not_found: resource organizations/ORG_NAME/environments/ENV_NAME not found\",\n \"status\": \"NOT_FOUND\"\n }\n}"}
-
-
Prüfen Sie die
ApigeeRoute-Ressourcen in Ihrem Namespace (standardmäßigapigee), um Routen zu identifizieren, die auf einen nicht vorhandenenApigeeDeploymentoder Dienst verweisen:kubectl get ApigeeRoute -n APIGEE_NAMESPACE kubectl describe ApigeeRoute APIGEE_ROUTE_NAME -n APIGEE_NAMESPACE
Lösung
-
Löschen Sie die ungültige
ApigeeRoute-Ressource:kubectl delete ApigeeRoute APIGEE_ROUTE_NAME -n APIGEE_NAMESPACE
-
Erstellen Sie die Routenkonfiguration neu, indem Sie das Helm-Diagramm
apigee-virtualhostnoch einmal anwenden:helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \ -n APIGEE_NAMESPACE \ --atomic \ --set envgroup=ENV_GROUP \ -f OVERRIDES_FILE
-
Wenn eine Umgebung nur in der Steuerungsebene gelöscht wurde (was zu
err fetching environment data: NOT_FOUNDführt), deinstallieren Sie den Helm-Release der Umgebung (helm delete ENV_RELEASE_NAME -n APIGEE_NAMESPACE) und entfernen Sie die Umgebung aus deroverrides.yaml-Datei, wie unter Umgebungen löschen beschrieben.
Ursache: Blockierter ausgehender Netzwerktraffic zu Google APIs
Die Komponente apigee-synchronizer fragt die Apigee-Steuerungsebene ab, um Laufzeitkonfigurationsverträge für die apigee-runtime-Pods herunterzuladen. apigee-watcher stellt eine Verbindung zur Steuerungsebene her, um die Ingress-Konfiguration abzurufen und den Bereitstellungsstatus zu melden. Wenn ausgehender Traffic von Cluster-Worker-Knoten zu Google APIs blockiert wird, können sich diese Komponenten nicht authentifizieren oder mit der Steuerungsebene kommunizieren.
Diagnose
-
Prüfen Sie die
apigee-synchronizer-Pod-Logs auf Authentifizierungs- und Verbindungszeitüberschreitungsfehler:kubectl logs -n APIGEE_NAMESPACE -l app=apigee-synchronizer --since=2h
Suchen Sie beim Abrufen eines Zugriffstokens nach
GoogleAuthException-Zeitüberschreitungsfehlern:"logger":"CONTRACT-REPLICATION","exceptionStackTrace":"com.google.auth.oauth2.GoogleAuthException: Error getting access token for service account: connect timed out, iss: SERVICE_ACCOUNT_EMAIL"
-
Prüfen Sie die Logs des
apigee-watcher-Pods auf Fehler bei der Verbindung zur Steuerungsebene:kubectl logs -n APIGEE_NAMESPACE -l app=apigee-watcher --since=2h
Suchen Sie nach
control-plane connectivity test failed-Fehlern mit einem TCP-Zeitlimit für Port443:{"level":"error","caller":"issuescan/cp_connectivity_scanner.go:68","msg":"control-plane connectivity test failed","organization":"ORG_NAME","error":"Get \"https://apigee.googleapis.com/v1/organizations/ORG_NAME\": oauth2: cannot fetch token: Post \"https://oauth2.googleapis.com/token\": dial tcp IP_ADDRESS:443: i/o timeout"}
Lösung
Prüfen Sie, ob Ihre ausgehenden Firewallregeln, NAT-Gateways, Netzwerk-ACLs und HTTP- oder HTTPS-Weiterleitungsproxy-Konfigurationen es Cluster-Worker-Knoten ermöglichen, *.googleapis.com:443 (einschließlich apigee.googleapis.com und oauth2.googleapis.com) zu erreichen. Eine vollständige Liste der erforderlichen Domains und Schritte zur Fehlerbehebung bei der Verbindung finden Sie unter Google Cloud-URLs für Hybrid zulassen und Keine Netzwerkverbindung zwischen Laufzeitebene und Steuerungsebene.
Ursache: Ingress-Gateway- oder Laufzeit-Pods sind nicht bereit
Um den Bereitstellungsstatus zu prüfen und zu melden, ruft apigee-watcher Routing-Konfigurations-Dumps von den apigee-ingressgateway-Pods ab und prüft die Bereitschaft der apigee-runtime-Pods. Wenn Ingress-Gateway-Pods nicht ausgeführt werden und bereit sind oder wenn Laufzeit-Pods den Umgebungsvertrag nicht geladen haben, schlägt die Berichterstellung zum Bereitstellungsstatus fehl.
Diagnose
-
Prüfen Sie den Status der
apigee-ingressgateway-Pods:kubectl get pods -n APIGEE_NAMESPACE -l app=apigee-ingressgateway
Prüfen Sie, ob alle
apigee-ingressgateway-Pods den StatusRunninghaben und2/2Container bereit sind. Wenn Ingress-Gateway-Pods nicht2/2ausführen, kannapigee-watcherden Envoy-Konfigurations-Dump nicht abrufen, der zur Überprüfung der Bereitstellung erforderlich ist. -
Prüfen Sie den Status der
apigee-runtime-Pods:kubectl get pods -n APIGEE_NAMESPACE -l app=apigee-runtime
Wenn
apigee-runtime-PodsRunning, aber nicht bereit sind (0/1), prüfen Sie die Pod-Ereignisse und -Logs:kubectl describe pod RUNTIME_POD_NAME -n APIGEE_NAMESPACE kubectl logs RUNTIME_POD_NAME -n APIGEE_NAMESPACE
Suchen Sie nach Fehlern bei der Bereitschaftsprüfung (
Readiness probe failed: HTTP probe failed with statuscode: 500) und nachREADINESS:VersionLoadProbe-Fehlern, die darauf hinweisen, dass der Laufzeitvertrag nicht geladen wurde:{"level":"SEVERE","className":"com.apigee.probe.ProbeServiceImpl","severity":"SEVERE","message":"probe \"READINESS:VersionLoadProbe\" execution failed due to Version not loaded by Message Processor","logger":"ProbeServiceImpl"}
Lösung
Beheben Sie alle Pod-Startfehler, Clusterressourcenbeschränkungen (CPU- oder Arbeitsspeicherlimits) oder Probleme beim Herunterladen von Synchronizer-Verträgen, damit apigee-ingressgateway-Pods 2/2 und apigee-runtime-Pods 1/1 erreichen, bevor Sie sie noch einmal bereitstellen. Weitere Schritte zur Fehlerbehebung bei apigee-runtime-Bereitschaftsfehlern finden Sie im Leitfaden zur Fehlerbehebung für Message Processor.
Verweise
- Virtuelle Hosts zu Apigee-Ingress-Gateway-Bereitstellungen zuordnen
- Umgebungen löschen
- Google Cloud-URLs, die für Hybrid zugelassen werden müssen
- Tipps zur Fehlerbehebung beim Message Processor