Stai visualizzando la documentazione di Apigee e Apigee hybrid.
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 è stato quello di demistificare l'arte e mostrare 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 per la risoluzione dei problemi sono destinati ai lettori che hanno una conoscenza di alto livello di Apigee e della relativa architettura, nonché una certa conoscenza di concetti di base come norme e analisi.
Alcuni problemi possono essere diagnosticati e risolti solo dagli utenti Apigee hybrid e potrebbero richiedere la conoscenza di componenti interni come i datastore Cassandra e Postgres, i processori di messaggi e i 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 di ripristino di Cassandra | Durante il ripristino di Cassandra in Apigee Hybrid, potresti riscontrare 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 |
| Rilevamento automatico dei problemi | Gruppo di ambienti mancante per l'host virtuale | Dopo aver eseguito kubectl -n apigee get apigeeissues, viene visualizzato
l'errore AIS_VIRTUALHOST_MISSING_ENVGROUP.
|
Solo Apigee hybrid |
| Rilevamento automatico dei problemi | Selezionatore mancante per l'host virtuale | 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 |
| Rilevamento automatico 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 possono causare lentezza nell'esecuzione del proxy Apigee hybrid o persino errori Datastore. A volte i log sono un'analisi
dei sintomi, anche prima dell'insorgenza dei sintomi.
|
Solo Apigee hybrid |
| Cassandra | Pod di Cassandra non 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 del pod Cassandra o 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 relativi al datastore Cassandra.
|
Solo Apigee hybrid |
| Deployment | I deployment di proxy API non riescono con avviso Nessun pod di runtime attivo | 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 | Risolvere i problemi relativi ai log di Apigee mancanti in Cloud Logging | Non sono noti messaggi di errore 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 sono noti messaggi di errore in questo scenario. | Solo Apigee hybrid |
| Configurazione di rete | Problemi di routing dell'accesso con Apigee |
I client esterni non sono in grado di accedere/connettersi ad Apigee in un
nel modo desiderato. Sono inclusi errori di connettività di rete
(errori di handshake TLS) o risposte 4xx/5xx di Apigee.
|
Apigee e Apigee hybrid |
| Configurazione di rete | Problemi di connettività di Apigee con i target PSC southbound |
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 essere svuotati perché hanno un conteggio delle repliche pari a 1, mentre sono necessarie almeno 3 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 le informazioni sulla build |
L'API buildinfo restituisce informazioni sulla compilazione corrente per un componente di runtime. Queste informazioni possono essere utili se
hai 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 va a buon fine con
un tasso di errori del 100%, puoi ignorare il problema. Si tratta di un comportamento previsto
comportamento degli utenti.
|
Solo Apigee hybrid |
| Deployment | L'istanza non segnala lo stato del 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 delle proprietà Istio per evitare problemi durante lo svuotamento dei nodi Istio |
Durante lo svuotamento dei pod Istio, alcuni nodi potrebbero non essere svuotati perché hanno un
conteggio di repliche pari a 1, mentre sono necessarie almeno 3 repliche. Per evitare che ciò accada, devi impostare il numero minimo di repliche
per ogni proprietà su 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 gli errori "503 Service Unavailable" con TARGET_CONNECT_TIMEOUT quando si utilizza il peering VPC. | Apigee |
| Configurazione di rete | Timeout del gateway (504) - Timeout lettura target | Questo documento descrive come diagnosticare e correggere gli errori "504 Gateway Timeout" con 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 ibrida di Apigee quando
sono bloccati in uno stato creating o releasing.
|
Solo Apigee hybrid |