Sie lesen gerade die Dokumentation zu Apigee und Apigee Hybrid.
Apigee Edge-Dokumentation aufrufen.
Die Fehlerbehebung ist sowohl eine Kunst als auch eine Wissenschaft. Das kontinuierliche Bestreben der Apigee-Teams für technischen Support besteht darin, die Kunst zu versachlichen und die Wissenschaft hinter der Problemidentifizierung und -lösung hervorzuheben.
Was sind Playbooks?
Die in Zusammenarbeit mit den Apigee-Teams für technischen Support entwickelten Playbooks zur Apigee-Fehlerbehebung bieten schnelle und effektive Lösungen für Fehler oder andere Probleme, die bei der Verwendung von Apigee-Produkten auftreten können.
Zielgruppe
Playbooks zur Fehlerbehebung richten sich an Leser, die umfassende Kenntnisse über Apigee und die zugehörige Architektur haben sowie die grundlegenden Konzepte von Richtlinien und Analysen kennen.
Einige Probleme können nur von Apigee Hybrid-Nutzern diagnostiziert und gelöst werden und erfordern möglicherweise Kenntnisse über interne Komponenten wie Cassandra- und Postgres-Datenspeicher, Message Processors und Router.
In Apigee wird deutlich gemacht, wann Sie die angegebenen Schritte zur Fehlerbehebung ausführen können und wann Sie sich an den Google Cloud-Kundensupport wenden müssen.
Playbooks
In diesem Abschnitt werden die aktuellen Playbooks beschrieben.
Zum Filtern dieser Tabelle haben Sie folgende Möglichkeiten: Wählen Sie eine Kategorie aus, wählen Sie ein Produkt aus, geben Sie einen Suchbegriff ein oder klicken Sie auf eine Spaltenüberschrift, um sie zu sortieren.
| Kategorie | Playbook/Problembeschreibung | Fehlermeldung | Playbook gilt für |
|---|---|---|---|
| Cassandra | Fehlerbehebung: Cassandra-Wiederherstellung | Während der Cassandra-Wiederherstellung in Apigee Hybrid können Fehler in den Wiederherstellungslogs auftreten. | Nur Apigee Hybrid |
| Automatisierte Problemsuche | Keine Netzwerkverbindung zwischen Laufzeitebene und Steuerungsebene | Verwaltungsanfragen von Apigee API schlagen fehl:
|
Nur Apigee Hybrid |
| Automatisierte Problemsuche | Virtueller Host ohne Umgebungsgruppe | Nachdem kubectl -n apigee get apigeeissues ausgeführt wurde, wird der Fehler AIS_VIRTUALHOST_MISSING_ENVGROUP angezeigt.
|
Nur Apigee Hybrid |
| Automatisierte Problemsuche | Virtueller Host ohne Selektor | Nachdem kubectl -n apigee get apigeeissues ausgeführt wurde, wird der Fehler AIS_VIRTUALHOST_MISSING_SELECTOR angezeigt.
|
Nur Apigee Hybrid |
| Automatisierte Problemsuche | Nicht übereinstimmendes Ingress-Zertifikat | Nachdem kubectl -n apigee get apigeeissues ausgeführt wurde, wird der Fehler AIS_INGRESS_CERT_MISMATCH angezeigt.
|
Nur Apigee Hybrid |
| Automatisierte Problemsuche | Ablauf des Ingress-Zertifikats | Nachdem kubectl -n apigee get apigeeissues ausgeführt wurde, wird der Fehler AIS_INGRESS_CERT_EXPIREY angezeigt.
|
Nur Apigee Hybrid |
| Automatisierte Problemsuche | Ablauf des Ingress-mTLS-CA-Zertifikats | Nachdem kubectl -n apigee get apigeeissues ausgeführt wurde, wird der Fehler AIS_INGRESS_MTLS_CA_CERT_EXPIREY angezeigt.
|
Nur Apigee Hybrid |
| Automatisierte Problemsuche | mTLS-CA-Zertifikat für eingehenden Traffic ungültig | Nachdem kubectl -n apigee get apigeeissues ausgeführt wurde, wird der Fehler AIS_INGRESS_MTLS_CA_CERT_INVALID angezeigt.
|
Nur Apigee Hybrid |
| Cassandra | Fehler bei der Cassandra-Datenreplikation | Wenn Sie Daten während einer multiregionalen Erweiterung replizieren, kann der Status CassandraDataReplication einen Fehlerstatus anzeigen und die Datenreplikation kann fehlschlagen. |
Nur Apigee Hybrid |
| Cassandra | Probleme mit dem Java-Heap-Speicher von Cassandra |
Cassandra-Heap-Probleme können zu einer Verlangsamung der Ausführung des Apigee Hybrid-Proxys oder sogar zu Datastore-Fehlern führen. Manchmal sind Protokolle ein frühes Warnzeichen, noch bevor die Symptome auftreten.
|
Nur Apigee Hybrid |
| Cassandra | Cassandra-Pods werden in der sekundären Region nicht gestartet |
Cassandra-Pods starten in einer der Regionen in einer multiregionalen Hybrid-Konfiguration nicht.
Möglicherweise wird die Fehlermeldung node already exists in den Cassandra-Pod-Logs oder die Warnung FailedPreStopHook im Cassandra-Pod-Status angezeigt.
|
Nur Apigee Hybrid |
| Cassandra | Tipps zur Fehlerbehebung für Cassandra |
Wenn Sie den Pod-Status mit kubectl aufrufen, sehen Sie, dass ein oder mehrere Cassandra-Pods hängen bleiben. In diesem Leitfaden werden die Diagnose und Lösung von Problemen mit dem Cassandra-Datenspeicher beschrieben.
|
Nur Apigee Hybrid |
| Bereitstellung | API-Proxy-Bereitstellungen schlagen ohne aktive Laufzeit-Pod-Warnung fehl | Die Warnung Keine aktiven Laufzeit-Pods wird im Dialogfeld Details neben der Fehlermeldung Probleme bei der Bereitstellung in ENVIRONMENT: REVISION_NUMBER angezeigt. | Nur Apigee Hybrid |
| Ingressgateway | API-Aufrufe schlagen mit Zeitüberschreitungsfehlern fehl |
curl: (7) Failed to connect to example.apis.com port 443: Operation timed out |
Nur Apigee Hybrid |
| Ingressgateway | API-Aufrufe schlagen mit TLS-Fehlern fehl |
curl: (35) LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to example.apis.com:443 |
Nur Apigee Hybrid |
| Logging | Fehlerbehebung bei fehlenden Apigee-Logs in Cloud Logging | Fehlermeldungen sind in diesem Szenario nicht bekannt. | Apigee und Apigee Hybrid |
| Verwaltung/UI | Inkonsistente/keine Daten für Entitäten in Hybrid-UI oder über Management APIs beobachtet | Fehlermeldungen sind in diesem Szenario nicht bekannt. | Nur Apigee Hybrid |
| Netzwerkkonfiguration | Zugriffsrouting-Probleme bei Apigee |
Externe Clients können nicht wie gewünscht auf Apigee zugreifen oder eine Verbindung dazu herstellen. Dazu gehören Netzwerkverbindungsfehler (TLS-Handshake-Fehler) und 4xx/5xx-Antworten von Apigee.
|
Apigee und Apigee Hybrid |
| Netzwerkkonfiguration | Verbindungsprobleme bei Apigee mit Southbound-PSC-Zielen |
Ein Netzwerkverbindungsproblem oder ein TCP-Zeitlimit zwischen Apigee und dem Zieldienst wird als Fehlerantwort 503 und mit einem Fehler wie dem folgenden angezeigt, wenn Sie eine Fehlerbehebungssitzung erstellen.
{"fault":{"faultstring":"The Service is temporarily unavailable","detail":{"errorcode":"messaging.adaptors.http.flow.ServiceUnavailable","reason":"TARGET_CONNECT_TIMEOUT"}}} |
Apigee und Apigee Hybrid |
| Sonstiges | Anzahl der Istio-Replikate beim Leeren von Knoten erhöhen | Wenn Sie Istio-Pods per Drain beenden, funktionieren einige Knoten möglicherweise nicht, da sie die Replikatanzahl 1 haben, wo 3 oder mehr Replikate erforderlich sind. Sie sollten daher für jedes Attribut die minimale Replikatanzahl auf 3 festlegen, um dies zu vermeiden. | Nur Apigee Hybrid |
| Sonstiges | Tipps zur Fehlerbehebung beim Nachrichtenverarbeiter |
Ein oder mehrere apigee-runtime-Pods haben nicht den Status Ready.
Wenn Sie kubectl zur Beschreibung eines fehlgeschlagenen apigee-runtime-Pods verwenden, wird folgender Fehler angezeigt:
Readiness probe failed: HTTP probe failed with statuscode: 500 |
Nur Apigee Hybrid |
| Sonstiges | Build-Informationen drucken |
Die buildinfo API gibt Informationen zum aktuellen Build für eine Laufzeitkomponente zurück. Diese Informationen sind hilfreich, wenn Sie sich an den Support wenden:
|
Nur Apigee Hybrid |
| Sonstiges | StreamingPull-Fehler 100 % |
Wenn Sie im Messwert-Dashboard sehen, dass die Methode google.pubsub.vl.Subscriber.StreamingPull mit Fehlern von 100 % fehlschlägt, können Sie das Problem einfach ignorieren. Dieses Verhalten ist normal.
|
Nur Apigee Hybrid |
| Bereitstellung | Instanz meldet den Status für die Umgebungsgruppe nicht | Bereitstellungen von API-Proxys schlagen in der Apigee Hybrid-Benutzeroberfläche mit dem Fehler "Instanz INSTANCE_NAME meldet den Status für den Umgebungsgruppenfehler ENV_GROUP_NAME nicht" fehl. | Nur Apigee Hybrid |
| Bereitstellung | API-Proxy-Bereitstellungen schlagen fehl, weil apigee-serving-cert nicht gefunden wurde oder abgelaufen ist |
API-Proxy-Bereitstellungen schlagen mit Fehlermeldungen in den apigee-watcher-Protokollen fehl.
|
Nur Apigee Hybrid |
| Ingressgateway | Anzahl der Istio-Attributreplikate maximieren, um Probleme beim Ableiten von Istio-Knoten zu vermeiden |
Wenn Sie Istio-Pods per Drain beenden, funktionieren einige Knoten möglicherweise nicht, da sie die Replikatanzahl 1 haben, wo 3 oder mehr Replikate erforderlich sind. Sie sollten daher für jedes Attribut die minimale Replikatanzahl auf 3 festlegen, um dies zu vermeiden.
|
Nur Apigee Hybrid |
| Netzwerkkonfiguration | Keine Fehlerbehebung bei freiem IP-Adressbereich | Wenn Sie während der Apigee-Bereitstellung einen Netzwerk-CIDR-Bereich auswählen, der nicht vollständig kostenlos ist, wird möglicherweise eine Fehlermeldung angezeigt. | Apigee und Apigee Hybrid |
| Netzwerkkonfiguration | Fehler VPC-Peering 503 Dienst nicht verfügbar mit TARGET_CONNECT_TIMEOUT | In diesem Dokument wird beschrieben, wie Sie Fehler vom Typ "503 Dienst nicht verfügbar" mit TARGET_CONNECT_TIMEOUT diagnostizieren und beheben, wenn VPC-Peering verwendet wird. | Apigee |
| Netzwerkkonfiguration | 504 Gateway-Zeitüberschreitung – Ziel-Lesezeitlimit | In diesem Dokument wird beschrieben, wie Sie Fehler vom Typ "504 Gateway-Zeitüberschreitung" mit dem Grund TARGET_READ_TIMEOUT diagnostizieren und beheben. | Apigee und Apigee Hybrid |
| Sonstiges | Fehlerbehebung, wenn Apigee Hybrid im Zustand „creating“ oder „releasing“ festhängt |
In diesem Dokument wird beschrieben, wie Sie Apigee-Komponenten zurücksetzen, wenn sie sich im Zustand creating oder releasing befinden.
|
Nur Apigee Hybrid |