Introduzione alle guide pratiche di Apigee e Apigee hybrid

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:

  • Prodotti API, sviluppatori e app non vengono compilati nell'interfaccia utente Apigee.
  • I deployment dei proxy API non vengono completati.
  • 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