Stai visualizzando la documentazione di Apigee e Apigee hybrid.
Visualizza la documentazione di
Apigee Edge.
La risoluzione dei problemi è sia un'arte che una scienza. L'impegno costante dei team di assistenza tecnica Apigee è stato quello di demistificare l'arte ed esporre la scienza alla base dell'identificazione e della risoluzione dei problemi.
Che cosa sono i playbook?
Sviluppati in collaborazione con i team di assistenza tecnica Apigee, i playbook per la risoluzione dei problemi di Apigee sono progettati per fornire soluzioni rapide ed efficaci a errori o altri problemi che potresti riscontrare quando utilizzi i prodotti Apigee.
Pubblico
I playbook per la risoluzione dei problemi sono destinati a lettori con una conoscenza di base di Apigee e della sua architettura, nonché di alcuni concetti di base come norme e analisi.
Alcuni problemi possono essere diagnosticati e risolti solo dagli utenti di Apigee Hybrid e potrebbero richiedere la conoscenza di componenti interni come Cassandra e Postgres, Message Processor e router.
Se utilizzi Apigee, specifichiamo chiaramente quando puoi eseguire i passaggi per la risoluzione dei problemi indicati e quando devi 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, seleziona un prodotto, digita un termine di ricerca o fai clic sull'intestazione di una colonna per ordinare.
Categoria | Descrizione del playbook/problema | Messaggio di errore | Playbook applicabile per |
---|---|---|---|
Cassandra | Errore di verifica del certificato TLS di Cassandra | Se il certificato CA Apigee non corrisponde nei cluster, la verifica del certificato TLS in Cassandra potrebbe non riuscire. | Solo Apigee hybrid |
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 |
Visualizzazione automatica dei problemi | Nessuna connettività di rete tra il piano di runtime e il control plane | Le richieste di gestione delle API Apigee non vanno a buon fine:
|
Solo Apigee hybrid |
Visualizzazione automatica 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 |
Visualizzazione 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 |
Visualizzazione automatica dei problemi | Mancata corrispondenza del certificato Ingress | Dopo aver eseguito kubectl -n apigee get apigeeissues , viene visualizzato l'errore
AIS_INGRESS_CERT_MISMATCH.
|
Solo Apigee hybrid |
Visualizzazione automatica dei problemi | Scadenza certificato Ingress | Dopo aver eseguito kubectl -n apigee get apigeeissues , viene visualizzato l'errore
AIS_INGRESS_CERT_EXPIREY.
|
Solo Apigee hybrid |
Visualizzazione automatica dei problemi | Scadenza del certificato CA mTLS Ingress | Dopo aver eseguito kubectl -n apigee get apigeeissues , viene visualizzato l'errore
AIS_INGRESS_MTLS_CA_CERT_EXPIREY.
|
Solo Apigee hybrid |
Visualizzazione automatica dei problemi | Ingress mTLS CA cert invalid | 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 di CassandraDataReplication potrebbe mostrare uno stato di errore e la replica dei dati potrebbe non riuscire.
|
Solo Apigee hybrid |
Cassandra | Problemi di spazio 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 indicatore
precoce, anche prima dell'insorgere dei sintomi.
|
Solo Apigee hybrid |
Cassandra | Pod di Cassandra non avviati nell'area geografica secondaria |
I pod di Cassandra non vengono avviati in una delle regioni in una configurazione ibrida multiregionale.
Potresti visualizzare un messaggio di errore node already exists nei log dei pod Cassandra o
un avviso FailedPreStopHook nello stato dei pod Cassandra.
|
Solo Apigee hybrid |
Cassandra | Guida alla risoluzione dei problemi di Cassandra |
Quando utilizzi kubectl per visualizzare gli stati dei pod, noti 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 | Deployment di proxy API non riusciti con avviso Nessun pod di runtime attivo | L'avviso Nessun pod di runtime attivo viene visualizzato nella finestra di dialogo Dettagli accanto al messaggio di errore Problemi di deployment su ENVIRONMENT: REVISION_NUMBER nella pagina del proxy API. | Solo Apigee hybrid |
Ingressgateway | Chiamate API che generano errori di timeout |
curl: (7) Failed to connect to example.apis.com port 443: Operation timed out |
Solo Apigee hybrid |
Ingressgateway | Chiamate API che generano errori TLS |
curl: (35) LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to example.apis.com:443 |
Solo Apigee hybrid |
Logging | Risoluzione dei problemi relativi ai log Apigee mancanti in Cloud Logging | In questo scenario non vengono visualizzati messaggi di errore noti. | Apigee e Apigee hybrid |
Gestione/UI | Dati incoerenti/inesistenti per le entità nella UI ibrida o tramite le API di gestione | In questo scenario non vengono visualizzati messaggi di errore noti. | 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 nel modo desiderato. Questi includono errori di connettività di rete
(handshake TLS non riuscito) o risposte 4xx/5xx da Apigee.
|
Apigee e Apigee hybrid |
Configurazione di rete | Problemi di connettività di Apigee con le destinazioni PSC in uscita |
Un problema di connessione di rete o un timeout TCP tra Apigee e il
servizio di destinazione verrà visualizzato come risposta di errore 503 e
mostrerà 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 di replica della proprietà Istio durante lo svuotamento dei nodi | Durante lo svuotamento dei pod Istio, alcuni nodi potrebbero non svuotarsi perché hanno un conteggio di repliche pari a 1, mentre sono richieste 3 o più repliche. Per evitare questo problema, devi impostare il numero minimo di repliche per ogni proprietà su 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 utilizzi kubectl per descrivere un pod apigee-runtime non riuscito, viene visualizzato l'errore:
Readiness probe failed: HTTP probe failed with statuscode: 500 |
Solo Apigee hybrid |
Altro | Stampa delle informazioni sulla build |
L'API buildinfo restituisce informazioni sulla build corrente
per un componente runtime. Queste informazioni possono essere utili se
devi contattare l'assistenza.
|
Solo Apigee hybrid |
Altro | Percentuale di errori StreamingPull del 100% |
Se nel dashboard delle metriche vedi che il metodo
google.pubsub.vl.Subscriber.StreamingPull non funziona con
il 100% di errori, puoi ignorare il problema. Questo è un comportamento previsto.
|
Solo Apigee hybrid |
Deployment | L'istanza non segnala lo stato per il gruppo di ambienti | I deployment dei proxy API non riescono a causa dell'errore L'istanza INSTANCE_NAME non segnala lo stato per il gruppo di ambienti ENV_GROUP_NAME nell'interfaccia utente ibrida di Apigee. | Solo Apigee hybrid |
Deployment | I deployment del proxy API non riescono perché apigee-serving-cert non è stato trovato o è scaduto |
I deployment di proxy API non riescono con messaggi di errore nei log di apigee-watcher .
|
Solo Apigee hybrid |
Ingressgateway | Espandi i conteggi di replica della proprietà Istio per evitare problemi durante lo svuotamento dei nodi Istio |
Durante lo svuotamento dei pod Istio, alcuni nodi potrebbero non svuotarsi perché hanno un
conteggio di replica pari a 1 , mentre sono richieste
3 o più repliche. Per evitare questo problema, devi impostare il numero minimo di repliche
per ogni proprietà su almeno 3 .
|
Solo Apigee hybrid |
Configurazione di rete | Nessuna risoluzione dei problemi dello spazio di indirizzi IP gratuito | Durante il provisioning di Apigee, se selezioni un intervallo CIDR di rete non completamente libero, potresti visualizzare un messaggio di errore. | Apigee e Apigee hybrid |
Configurazione di rete | Errore 503 Servizio non disponibile con TARGET_CONNECT_TIMEOUT (target di peering internet e VPC) | Questo documento descrive come diagnosticare e correggere gli errori "503 Service Unavailable" con TARGET_CONNECT_TIMEOUT quando utilizzi target di peering internet o VPC. | Apigee |
Configurazione di rete | 504 Gateway timeout - Target read timeout | 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 nello stato di creazione o rilascio |
Questo documento descrive come reimpostare i componenti di Apigee Hybrid quando
sono bloccati nello stato creating o releasing .
|
Solo Apigee hybrid |
Installazione e upgrade di Apigee hybrid | Pod Cassandra in stato CrashLoopBackOff | I pod Cassandra sono bloccati nello stato CrashLoopBackOff dopo l'installazione o l'upgrade. | Solo Apigee hybrid |