Instanz meldet den Status für die Umgebungsgruppe nicht

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:

instance-not-reporting-status

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_NAME

Lö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

  1. 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 ApigeeRoute verweist 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}"}
  2. Prüfen Sie die ApigeeRoute-Ressourcen in Ihrem Namespace (standardmäßig apigee), um Routen zu identifizieren, die auf einen nicht vorhandenen ApigeeDeployment oder Dienst verweisen:

    kubectl get ApigeeRoute -n APIGEE_NAMESPACE
    kubectl describe ApigeeRoute APIGEE_ROUTE_NAME -n APIGEE_NAMESPACE
    

Lösung

  1. Löschen Sie die ungültige ApigeeRoute-Ressource:

    kubectl delete ApigeeRoute APIGEE_ROUTE_NAME -n APIGEE_NAMESPACE
    
  2. Erstellen Sie die Routenkonfiguration neu, indem Sie das Helm-Diagramm apigee-virtualhost noch einmal anwenden:

    helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
      -n APIGEE_NAMESPACE \
      --atomic \
      --set envgroup=ENV_GROUP \
      -f OVERRIDES_FILE
    
  3. Wenn eine Umgebung nur in der Steuerungsebene gelöscht wurde (was zu err fetching environment data: NOT_FOUND führt), deinstallieren Sie den Helm-Release der Umgebung (helm delete ENV_RELEASE_NAME -n APIGEE_NAMESPACE) und entfernen Sie die Umgebung aus der overrides.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

  1. 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"
  2. 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 Port 443:

    {"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

  1. 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 Status Running haben und 2/2 Container bereit sind. Wenn Ingress-Gateway-Pods nicht 2/2 ausführen, kann apigee-watcher den Envoy-Konfigurations-Dump nicht abrufen, der zur Überprüfung der Bereitstellung erforderlich ist.

  2. Prüfen Sie den Status der apigee-runtime-Pods:

    kubectl get pods -n APIGEE_NAMESPACE -l app=apigee-runtime
    

    Wenn apigee-runtime-Pods Running, 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 nach READINESS: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