Stai visualizzando la documentazione relativa a Apigee e Apigee ibrido.
Visualizza
Documentazione di Apigee Edge.
La risoluzione dei problemi è sia un'arte che una scienza. L'impegno costante dei team di assistenza tecnica di Apigee ha chiarito l'arte ed esporre la scienza alla base dell'identificazione e della risoluzione dei problemi.
Che cosa sono i playbook?
Sviluppato in collaborazione con i team di assistenza tecnica di Apigee, Apigee i playbook per la risoluzione dei problemi sono progettati per fornire in modo rapido ed efficace soluzioni agli errori o ad altri problemi che potresti riscontrare quando lavori Prodotti Apigee.
Pubblico
I playbook di risoluzione dei problemi sono destinati a lettori con un alto livello di Apigee e della sua architettura, oltre che comprensione di concetti base come norme e analisi.
Alcuni problemi possono essere diagnosticati e risolti solo dagli utenti ibridi Apigee e può richiedere la conoscenza di componenti interni come Cassandra e Datastore Postgres, processori di messaggi e router.
Se usi Apigee, specifichiamo chiaramente quando puoi eseguire indicato i passaggi per la risoluzione dei problemi e quando è necessario contattare l'assistenza clienti Google Cloud per ricevere assistenza.
Guide pratiche
Questa sezione descrive i playbook attuali.
Per filtrare questa tabella, esegui una o più delle seguenti operazioni: seleziona una categoria, selezionare un prodotto, digitare un termine di ricerca o fare clic sull'intestazione di una colonna per ordinare.
Categoria | Guida pratica/descrizione del problema | Messaggio di errore | Playbook applicabile a |
---|---|---|---|
Cassandra | Risoluzione dei problemi relativi al ripristino di Cassandra | Durante il ripristino di Cassandra in Apigee hybrid, potresti riscontrare e gli errori nei log di ripristino. | Solo Apigee hybrid |
Generazione automatica dei problemi | Nessuna connettività di rete tra il piano di runtime e quello di controllo | Le richieste di gestione delle API Apigee non vanno a buon fine:
|
Solo Apigee hybrid |
Generazione automatica dei problemi | Host virtuale mancante per il gruppo di ambienti | Dopo aver eseguito kubectl -n apigee get apigeeissues ,
Viene visualizzato l'errore AIS_VIRTUALHOST_MISSING_ENVGROUP.
|
Solo Apigee hybrid |
Generazione automatica dei problemi | Selettore host virtuale mancante | Dopo aver eseguito kubectl -n apigee get apigeeissues ,
Viene visualizzato l'errore AIS_VIRTUALHOST_MISSING_SELECTOR.
|
Solo Apigee hybrid |
Generazione automatica dei problemi | Certificato in entrata non corrispondente | Dopo aver eseguito kubectl -n apigee get apigeeissues ,
Viene visualizzato l'errore AIS_INGRESS_CERT_MISMATCH.
|
Solo Apigee hybrid |
Generazione automatica dei problemi | Scadenza del certificato in entrata | Dopo aver eseguito kubectl -n apigee get apigeeissues ,
Viene visualizzato l'errore AIS_INGRESS_CERT_EXPIREY.
|
Solo Apigee hybrid |
Generazione automatica dei problemi | Scadenza del certificato CA mTLS in entrata | Dopo aver eseguito kubectl -n apigee get apigeeissues ,
Viene visualizzato l'errore AIS_INGRESS_MTLS_CA_CERT_EXPIREY.
|
Solo Apigee hybrid |
Generazione automatica dei problemi | Certificato CA mTLS in entrata non valido | Dopo aver eseguito kubectl -n apigee get apigeeissues ,
Viene visualizzato l'errore AIS_INGRESS_MTLS_CA_CERT_INVALID.
|
Solo Apigee hybrid |
Cassandra | Errore di replica dei dati Cassandra |
Durante la replica dei dati durante un'espansione multiregionale,
Lo stato CassandraDataReplication può mostrare dati e uno stato di errore
la replica potrebbe non riuscire.
|
Solo Apigee hybrid |
Cassandra | Problemi di spazio nell'heap Java di Cassandra |
I problemi di heap di Cassandra potrebbero causare rallentamenti nel proxy ibrido Apigee
o addirittura Datastore errori. A volte i log sono un'analisi
l'indicatore, anche prima dell'insorgenza dei sintomi.
|
Solo Apigee hybrid |
Cassandra | I pod Cassandra non vengono avviati nella regione secondaria |
I pod Cassandra non si avviano in una delle regioni in una configurazione ibrida multiregionale.
Potresti visualizzare un messaggio di errore node already exists nei log dei pod Cassandra oppure
un avviso FailedPreStopHook nello stato del pod Cassandra.
|
Solo Apigee hybrid |
Cassandra | Guida alla risoluzione dei problemi di Cassandra |
Quando utilizzi kubectl per visualizzare gli stati dei pod, puoi vedere che
uno o più pod Cassandra sono bloccati. Questa guida descrive la diagnosi
e la risoluzione dei problemi
con il datastore Cassandra.
|
Solo Apigee hybrid |
Deployment | I deployment del proxy API non riescono senza nessun avviso sui pod di runtime attivi | In Dettagli viene visualizzato l'avviso Nessun pod di runtime attivo finestra di dialogo accanto al messaggio di errore Problemi di deployment in ENVIRONMENT: REVISION_NUMBER nella pagina del proxy API. | Solo Apigee hybrid |
Ingressgateway | Chiamate API non riuscite e errori di timeout |
curl: (7) Failed to connect to example.apis.com port 443: Operation timed out |
Solo Apigee hybrid |
Ingressgateway | Chiamate API non riuscite con errori TLS |
curl: (35) LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to example.apis.com:443 |
Solo Apigee hybrid |
Logging | Risoluzione dei problemi dei log Apigee mancanti in Cloud Logging | Non è noto che messaggi di errore vengano mostrati in questo scenario. | Apigee e Apigee hybrid |
Gestione/UI | Sono stati rilevati dati incoerenti o assenti per le entità nella UI ibrida o tramite le API di gestione | Non è noto che messaggi di errore vengano mostrati in questo scenario. | Solo Apigee hybrid |
Configurazione di rete | Problemi di routing degli accessi con Apigee . |
I client esterni non sono in grado di accedere/connettersi ad Apigee in un
nel modo desiderato. Sono inclusi gli errori di connettività di rete
(handshake TLS non riuscito) o 4xx/5xx risposte da Apigee.
|
Apigee e Apigee hybrid |
Configurazione di rete | Problemi di connettività Apigee con le destinazioni PSC associate a sud . |
Un problema di connessione di rete o un timeout TCP tra Apigee e il
servizio di destinazione viene visualizzato come risposta di errore 503 e
viene visualizzato un errore simile a quello riportato di seguito se crei una sessione di debug.
{"fault":{"faultstring":"The Service is temporarily unavailable","detail":{"errorcode":"messaging.adaptors.http.flow.ServiceUnavailable","reason":"TARGET_CONNECT_TIMEOUT"}}} |
Apigee e Apigee hybrid |
Altro | Espansione dei conteggi delle repliche delle proprietà Istio durante lo svuotamento dei nodi | Durante lo svuotamento dei pod Istio, alcuni nodi potrebbero non svuotarsi a causa un numero di repliche è pari a 1, mentre sono necessarie 3 o più repliche. Per evita questo, devi impostare il numero minimo di repliche per ogni proprietà ad almeno 3. | Solo Apigee hybrid |
Altro | Guida alla risoluzione dei problemi del processore di messaggi |
Uno o più pod apigee-runtime non sono nello stato Ready .
Quando usi kubectl per descrivere un errore
apigee-runtime pod, viene visualizzato l'errore:
Readiness probe failed: HTTP probe failed with statuscode: 500 |
Solo Apigee hybrid |
Altro | Stampa informazioni sulla build |
L'API buildinfo restituisce informazioni sulla configurazione
per un componente di runtime. Queste informazioni possono essere utili
abbiamo bisogno di contattare l'assistenza.
|
Solo Apigee hybrid |
Altro | Errori StreamingPull 100% |
Se nella dashboard delle metriche noti che il metodo
google.pubsub.vl.Subscriber.StreamingPull non funziona con
100% errori, puoi tranquillamente ignorare il problema. Si tratta di un comportamento previsto
comportamento degli utenti.
|
Solo Apigee hybrid |
Deployment | L'istanza non segnala lo stato per il gruppo di ambienti | I deployment dei proxy API hanno esito negativo con l'istanza INSTANCE_NAME non segnala lo stato per il gruppo di ambienti ENV_GROUP_NAME nella UI ibrida di Apigee. | Solo Apigee hybrid |
Deployment | I deployment del proxy API hanno esito negativo e apigee-serving-cert non è stato trovato o scaduto |
I deployment dei proxy API non riescono e ricevono messaggi di errore nel
apigee-watcher di log.
|
Solo Apigee hybrid |
Ingressgateway | Espandi i conteggi delle repliche della proprietà Istio per evitare problemi durante lo svuotamento Nodi Istio |
Durante lo svuotamento dei pod Istio, alcuni nodi potrebbero non svuotarsi a causa
numero di repliche di 1 , mentre 3 o più repliche
obbligatorio. Per evitare che ciò accada, devi impostare il numero minimo di repliche
per ogni proprietà fino ad almeno 3 .
|
Solo Apigee hybrid |
Configurazione di rete | Risoluzione dei problemi relativi allo spazio di indirizzi IP libero non disponibile | Durante il provisioning di Apigee, se selezioni un intervallo CIDR della rete che non è completamente gratuita, potresti visualizzare un messaggio di errore. | Apigee e Apigee hybrid |
Configurazione di rete | Errore di servizio di peering VPC 503 non disponibile con TARGET_CONNECT_TIMEOUT | Questo documento descrive come diagnosticare e correggere il messaggio "503 Service Non disponibile" con errori relativi a TARGET_CONNECT_TIMEOUT quando si utilizza il peering VPC. | Apigee |
Configurazione di rete | 504 Timeout gateway - Timeout di lettura della destinazione | Questo documento descrive come diagnosticare e correggere "504 Gateway Timeout" (Timeout del gateway 504) con errori relativi a per un motivo TARGET_READ_TIMEOUT. | Apigee e Apigee hybrid |
Altro | Risoluzione dei problemi di Apigee hybrid bloccato nella creazione o nel rilascio dello stato |
Questo documento descrive come reimpostare i componenti ibridi di Apigee quando
sono bloccati in un creating o releasing
stato.
|
Solo Apigee hybrid |