API-Aufrufe schlagen mit Zeitüberschreitungsfehlern fehl
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Sie lesen gerade die Dokumentation zu Apigee und Apigee Hybrid. Apigee Edge-Dokumentation aufrufen.
Symptom
Möglicherweise tritt eines der folgenden Symptome auf:
Die Clientanwendungen erhalten Zeitüberschreitungsfehler als Antwort auf API-Aufrufe in Apigee Hybrid.
Sie beobachten Fehler wie Error from server (invalid) oder The Job
"apigee-resources-install" is invalid , wenn Sie die Konfiguration (overrides.yaml) während der Apigee Hybrid-Installation auf den Cluster anwenden.
Fehlermeldungen
Möglicherweise tritt einer der folgenden Fehler auf:
Fehlerantwort auf API-Aufrufe
Die API-Anfragen in Apigee Hybrid können mit der folgenden Fehlermeldung fehlschlagen:
* Connection failed
* connect to 34.84.67.39 port 443 failed: Operation timed out
* Failed to connect to example.apis.com port 443: Operation timed out
* Closing connection 0
curl: (7) Failed to connect to example.apis.com port 443: Operation timed out
Beim Anwenden der Konfiguration (overrides.yaml) auf Cluster beobachtete Fehler
Während der Installation kann einer der folgenden Fehler auftreten, wenn Sie die Konfiguration (Datei overrides.yaml) auf Cluster anwenden:
Fehler Nr. 1
apigeectl init -f overrides/overrides.yaml
...
...
Error from server (Invalid): error when applying patch:
to:
Resource: "batch/v1, Resource=jobs", GroupVersionKind: "batch/v1, Kind=Job"
Name: "istio-init-crd-10-1.4.6", Namespace: "istio-system"
to:
Resource: "batch/v1, Resource=jobs", GroupVersionKind: "batch/v1, Kind=Job"
Name: "istio-init-crd-11-1.4.6", Namespace: "istio-system"
to:
Resource: "batch/v1, Resource=jobs", GroupVersionKind: "batch/v1, Kind=Job"
Name: "istio-init-crd-14-1.4.6", Namespace: "istio-system"
Diese Fehler können auftreten, wenn der Dienst istio-ingressgateway den Status pending hat und nicht an eine externe IP-Adresse gebunden werden kann, wie unten dargestellt:
kubectl get services -n istio-system
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
istio-ingressgateway LoadBalancer 10.198.5.104 <pending> 15020:31927/TCP, 12h
80:31381/TCP,
443:31391/TCP,
31400:31401/TCP,
15443:32623/TCP
Mögliche Gründe dafür, dass sich der istio-ingressgateway-Dienst im Status pending befindet:
Die incomplete/erroneous-Jobs im istio-system-Namespace können dazu führen, dass sich der istio-ingressgateway-Dienst für immer im Status pending befindet und nicht an eine externe IP-Adresse gebunden werden kann.
Die incomplete-Jobs im apigee-system-Namespace können dazu führen, dass sich der istio- ingressgateway-Dienst für immer im Status pending befindet und nicht an eine externe IP-Adresse gebunden werden kann.
In der Datei istio-operator.yaml ist möglicherweise ein falscher IP-Adressbereich konfiguriert, sodass der istio-ingressgateway-Dienst für immer den Status pending erhält und sich während der Installation nicht an eine externe IP-Adresse binden kann.
Ursache: Jobs im istio-system-Namespace im Status "fehlerhaft"/"ausstehend"
Diagnose
Prüfen Sie den Status der Jobs im istio-system-Namespace mit dem folgenden Befehl:
kubectl get jobs -n istio-system
Der Status der Jobs muss complete lauten. Wenn der Status der Jobs erroneous/pending lautet, ist dies die Ursache des Problems.
Lösung
Wenn einer der Jobs den Status pending oder erroneous hat, löschen Sie ihn mit dem folgenden Befehl:
Führen Sie die Installation noch einmal aus, indem Sie die Datei overrides.yaml anwenden:
apigeectl apply -f overrides.yaml
Ursache: Der apigee-resources-install-Job im apigee-system-Namespace kann sich im Status "fehlerhaft" befinden
Diagnose
Prüfen Sie den Status der Jobs im apigee-system-Namespace mit dem folgenden Befehl:
kubectl get jobs -n apigee-system
Der Status der Jobs muss complete lauten. Wenn der Status der Jobs erroneous/pending lautet, ist dies die Ursache des Problems. Die folgende Beispielausgabe zeigt, dass der Job apigee-resources-install erfolgreich abgeschlossen wurde.
kubectl get jobs -n apigee-system
NAME COMPLETIONS DURATION AGE
apigee-resources-install 1/1 23s 16d
Lösung
Wenn die Jobs den Status pending oder erroneous haben, löschen Sie sie mit dem folgenden Befehl:
Führen Sie die Installation noch einmal aus, indem Sie die Datei overrides.yaml anwenden:
apigeectl apply -f overrides.yaml
Ursache: Dem externen Load-Balancer wurde ein falscher IP-Adressbereich zugewiesen
Diagnose
Prüfen Sie die für den Load-Balancer konfigurierte IP-Adresse in der Datei istio-
operator.yaml. Das folgende Snippet zeigt beispielsweise die Stelle in der Datei istio-operator.yaml, an der die IP-Adresse konfiguriert ist:
Der Dienst istio-ingressgateway wird in der Datei istio-operator.yaml als Load-Balancer konfiguriert (dargestellt durch den Typ). Während der ASM-Installation wird ein Load-Balancer mit der konfigurierten IP-Adresse erstellt und zur Kommunikation mit dem Dienst istio-
ingressgateway verbunden. Daher sollte die konfigurierte IP-Adresse korrekt und für den Load-Balancer reserviert sein.
Wenden Sie sich an Ihr Netzwerkteam und prüfen Sie, ob die für loadBalancerIP konfigurierte IP-Adresse korrekt ist. Wenn sie falsch ist, kann der Load-Balancer-Dienst nicht an die IP-Adresse gebunden werden. Dadurch bleibt der Dienst istio-ingressgateway dauerhaft im Status pending.
Lösung
Arbeiten Sie mit Ihrem Netzwerkteam zusammen und konfigurieren Sie die richtige IP-Adresse in der Datei istio-
operator.yaml.
Führen Sie die ASM-Installation noch einmal aus und wenden Sie die Datei overrides.yaml an:
apigeectl apply -f overrides.yaml
Erfassen von Diagnoseinformationen erforderlich
Wenn das Problem auch nach Befolgen der obigen Anweisungen weiterhin besteht, sammeln Sie die folgenden Diagnoseinformationen und wenden Sie sich dann an Google Cloud Customer Care:
Die Google Cloud-Projekt-ID
Der Name der Apigee Hybrid-Organisation
Kubernetes-Clustername
Google Cloud-Projektname, wenn sich der Kubernetes-Cluster in einem anderen Google Cloud-Projekt befindet
Datei overrides.yaml
Die Datei Istio-operator .yaml, die während der ASM-Installation verwendet wird
Erfassen Sie die Logs von jedem istio-ingressgateway-Pod im istio-system-Namespace:
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-28 (UTC)."],[[["\u003cp\u003eThis document addresses issues where Apigee hybrid API calls time out or configuration applications to the cluster fail.\u003c/p\u003e\n"],["\u003cp\u003eThe primary symptoms of these issues include timeout errors for client applications and specific errors during the application of \u003ccode\u003eoverrides.yaml\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe root cause of these symptoms is often the \u003ccode\u003eistio-ingressgateway\u003c/code\u003e service being in a \u003ccode\u003epending\u003c/code\u003e state and unable to bind to an external IP address.\u003c/p\u003e\n"],["\u003cp\u003eSolutions involve checking and resolving incomplete or erroneous jobs in the \u003ccode\u003eistio-system\u003c/code\u003e or \u003ccode\u003eapigee-system\u003c/code\u003e namespaces and ensuring the correct IP address range is configured for the external load balancer.\u003c/p\u003e\n"],["\u003cp\u003eIf the problem persists, diagnostic information such as logs, service lists, project IDs, and configuration files should be collected for Google Cloud Customer Care assistance.\u003c/p\u003e\n"]]],[],null,["# API calls fail with timeout errors\n\n*You're viewing **Apigee** and **Apigee hybrid** documentation.\nView [Apigee Edge](https://docs.apigee.com/api-platform/troubleshoot/404-support-d) documentation.*\n| **Note:** This document is applicable for Apigee hybrid users only.\n\nSymptom\n-------\n\n\nYou may observe one of the following symptoms:\n\n1. The client applications get timeout errors as a response for API calls on Apigee hybrid.\n2. You observe errors such as `Error from server (invalid)` or `The Job\n \"apigee-resources-install\" is invalid` while applying configuration (`overrides.yaml`) to the cluster during hybrid installation.\n\nError messages\n--------------\n\n\nYou may observe one of the following errors:\n\n### Error response to API calls\n\n\nThe API requests on Apigee hybrid may fail with the following error message: \n\n```scdoc\n* Connection failed\n* connect to 34.84.67.39 port 443 failed: Operation timed out\n* Failed to connect to example.apis.com port 443: Operation timed out\n* Closing connection 0\ncurl: (7) Failed to connect to example.apis.com port 443: Operation timed out\n```\n\n### Errors observed while applying configuration (overrides.yaml) to clusters\n\n\nYou may observe one of the following errors while applying configuration\n(`overrides.yaml` file) to clusters during the installation: \n\n### Error #1\n\n```\nhelm upgrade operator apigee-operator/ \\\n --install \\\n --create-namespace \\\n --namespace APIGEE_NAMESPACE \\\n --atomic \\\n -f OVERRIDES_FILE\n```\n\n\u003cbr /\u003e\n\n```text\n...\n...\nError from server (Invalid): error when applying patch:\nto:\nResource: \"batch/v1, Resource=jobs\", GroupVersionKind: \"batch/v1, Kind=Job\"\nName: \"istio-init-crd-10-1.4.6\", Namespace: \"istio-system\"\nto:\nResource: \"batch/v1, Resource=jobs\", GroupVersionKind: \"batch/v1, Kind=Job\"\nName: \"istio-init-crd-11-1.4.6\", Namespace: \"istio-system\"\nto:\nResource: \"batch/v1, Resource=jobs\", GroupVersionKind: \"batch/v1, Kind=Job\"\nName: \"istio-init-crd-14-1.4.6\", Namespace: \"istio-system\"\n```\n\n### Error #2\n\n```\nhelm upgrade operator apigee-operator/ \\\n--install \\\n--create-namespace \\\n--namespace APIGEE_NAMESPACE \\\n--atomic \\\n-f OVERRIDES_FILE\n```\n\n\u003cbr /\u003e\n\n```carbon\n...\n...\nThe Job \"apigee-resources-install\" is invalid: spec.template: Invalid value:\ncore.PodTemplateSpec{ObjectMeta:v1.ObjectMeta{Name:\"apigee-resources-install\",\nGenerateName:\"\", Namespace:\"\", SelfLink:\"\", UID:\"\", ResourceVersion:\"\",\nGeneration:0,\n```\n\nPossible causes\n---------------\n\n\nThese errors can happen if the `istio-ingressgateway` service is in a\n`pending` state and unable to bind to an external IP address as shown below: \n\n```\nkubectl get services -n istio-system\nNAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE\nistio-ingressgateway LoadBalancer 10.198.5.104 \u003cpending\u003e 15020:31927/TCP, 12h\n 80:31381/TCP,\n 443:31391/TCP,\n 31400:31401/TCP,\n 15443:32623/TCP\n```\n\n\nThe possible causes for the `istio-ingressgateway` service to be in a\n`pending` state are as follows:\n\nCause: Jobs in istio-system namespace in erroneous/pending state\n----------------------------------------------------------------\n\n### Diagnosis\n\n1. Check the status of the jobs in the `istio-system` namespace using the following command: \n\n ```\n kubectl get jobs -n istio-system\n ```\n2. The status of the jobs must be `complete`. If the status of the jobs is in an `erroneous/pending` state, then that's the cause of this problem.\n\n### Resolution\n\n1. If any of the jobs are in the `pending` or `erroneous` state, delete them using the following command: \n\n ```\n kubectl -n istio-system delete job JOB_NAME_FROM_STEP_1\n ```\n2. Re-run the installation by applying the `overrides.yaml` file:\n\n\n Update the `apigee-serving-cert` using\n [Helm](/apigee/docs/hybrid/latest/helm-reference): \n\n ```\n helm install operator apigee-operator/\n --namespace APIGEE_NAMESPACE \\\n --atomic \\\n -f OVERRIDES_FILE \\\n --dry-run=server\n ```\n\n Make sure to include all of the settings shown, including `--atomic`\n so that the action rolls back on failure.\n\n Install the chart: \n\n ```\n helm upgrade operator apigee-operator/\n --namespace APIGEE_NAMESPACE \\\n --atomic \\\n -f OVERRIDES_FILE\n ```\n\nCause: apigee-resources-install job in the apigee-system namespace may be in erroneous state\n--------------------------------------------------------------------------------------------\n\n| **Note:** The `apigee-resources-install` job is not part of hybrid versions 1.13 and later.\n\n### Diagnosis\n\n1. Check the status of the jobs in the `apigee-system` namespace using the following command: \n\n ```\n kubectl get jobs -n apigee-system\n ```\n2. The status of the jobs must be `complete`. If the status of the jobs is in an `erroneous/pending` state, then that's the cause of this problem. The following sample output shows that the job `apigee-resources-install `is successfully completed. \n\n ```\n kubectl get jobs -n apigee-system\n NAME COMPLETIONS DURATION AGE\n apigee-resources-install 1/1 23s 16d\n ```\n\n### Resolution\n\n1. If the jobs are in the `pending` or `erroneous` state, delete them using the following command: \n\n ```\n kubectl -n apigee-system delete job JOB_NAME_FROM_STEP_1\n ```\n2. Re-run the installation by applying the `overrides.yaml` file: \n\n ```\n apigeectl apply -f overrides.yaml\n ```\n\nCause: Incorrect IP address range assigned to external load balancer\n--------------------------------------------------------------------\n\n### Diagnosis\n\n1. Check the IP address configured for the load balancer in the `istio-\n operator.yaml` file. For example, the following snippet shows the location in the `istio-operator.yaml` file where the IP address is configured: \n\n ```gdscript\n -name: istio-ingressgateway\n enabled: true\n k8s:\n service:\n type: LoadBalancer\n loadBalancerIP: 10.195.24.23\n ```\n2. The `istio-ingressgateway` service is configured as a load balancer (indicated by type) in the `istio-operator.yaml` file. During the ASM installation, a load balancer is created with the configured IP address and wired to communicate with the `istio-\n ingressgateway` service. Therefore, the IP address configured should be correct and reserved for the load balancer.\n3. Engage your network team and verify that the IP address configured for `loadBalancerIP` is correct. If it is incorrect, then the load balancer service will not be able to bind to the IP address. This causes the `istio-ingressgateway` service to be in the `pending` state forever.\n\n### Resolution\n\n1. Work with your network team and configure the correct IP address in the `istio-\n operator.yaml` file.\n2. Re-run the installation for the [Apigee ingress gateway](/apigee/docs/hybrid/latest/managing-ingress) and apply the `overrides.yaml` file: \n\n ```\n helm upgrade $ORG_NAME apigee-org/ \\\n --install \\\n --namespace APIGEE_NAMESPACE \\\n --atomic \\\n -f OVERRIDES_FILE\n ```\n\nMust gather diagnostic information\n----------------------------------\n\n\nIf the problem persists even after following the above instructions, gather the following\ndiagnostic information and then contact [Google Cloud Customer Care](https://cloud.google.com/support-hub/):\n\n1. The Google Cloud Project ID\n2. The name of the Apigee hybrid organization\n3. Kubernetes Cluster name\n4. Google Cloud project name if kubernetes cluster resides in different Google Cloud project\n5. The `overrides.yaml` file\n6. The `Istio-operator .yaml` file used during the ASM installation.\n7. Collect the logs from each `istio-ingressgateway` pod in the `istio-system` namespace: \n\n ```\n kubectl logs NAME_OF_ISTIO_INGRESSGATEWAY_POD -n istio-system \u003e /tmp/NAME_OF_ISTIO_INGRESSGATEWAY_POD.log\n ```\n8. Collect the description of the each pod in the `istio-system` namespace: \n\n ```\n kubectl describe pod NAME_OF_ISTIO_INGRESSGATEWAY_POD -n istio-system \u003e /tmp/NAME_OF_ISTIO_INGRESSGATEWAY_POD.yaml\n ```\n9. Collect the list of services in the `istio-system` namespace: \n\n ```\n kubectl get svc -n istio-system\n ```"]]
