Questa guida descrive come risolvere i problemi di configurazione per i bilanciatori del carico delle applicazioni esterni. Prima di esaminare i problemi, acquisisci familiarità con le seguenti pagine:
- Panoramica del bilanciatore del carico delle applicazioni esterno
- Logging e monitoraggio del bilanciatore del carico delle applicazioni globale e classico
- Logging e monitoraggio del bilanciatore del carico delle applicazioni esterno regionale
Risolvere i problemi comuni di Network Analyzer
Network Analyzer monitora automaticamente la configurazione di rete VPC e rileva sia le configurazioni non ottimali sia quelle errate. Identifica gli errori di rete, fornisce informazioni sulla causa principale e suggerisce possibili soluzioni. Per scoprire i diversi scenari di configurazione errata rilevati automaticamente da Network Analyzer, consulta Approfondimenti sul bilanciatore del carico nella documentazione di Network Analyzer.
Network Analyzer è disponibile nella console Google Cloud come parte di Network Intelligence Center.
Vai a Network AnalyzerI backend hanno modalità di bilanciamento incompatibili
Quando crei un bilanciatore del carico, potresti visualizzare l'errore:
Validation failed for instance group INSTANCE_GROUP: backend services 1 and 2 point to the same instance group but the backends have incompatible balancing_mode. Values should be the same.
Ciò si verifica quando tenti di utilizzare lo stesso backend in due bilanciatori del carico diversi e i backend non hanno modalità di bilanciamento compatibili.
Per ulteriori informazioni, consulta le seguenti risorse:
- Limitazioni e indicazioni per i gruppi di istanze
- Modifica la modalità di bilanciamento di un bilanciatore del carico
Risolvere i problemi di connettività generali
Errori "5XX" inspiegabili
Un errore "HTTP 5XX" può essere restituito da un GFE di primo livello, da un GFE di secondo livello o da un backend, a seconda di dove si verifica la condizione di errore.
Questa sezione descrive come risolvere i problemi relativi agli errori 5XX che possono verificarsi in diverse fasi del processo di distribuzione delle richieste per i bilanciatori del carico delle applicazioni esterni basati su GFE.
Identificare l'origine degli errori "5XX" utilizzando Cloud Logging
Per le condizioni di errore causate da un problema di comunicazione tra il proxy del bilanciatore del carico e i relativi backend, il bilanciatore del carico genera un codice di risposta di errore HTTP (5XX) e lo restituisce al client. Non tutti gli errori HTTP 5XX vengono generati dal bilanciatore del carico. Ad esempio, se un backend invia una risposta HTTP 5XX al bilanciatore del carico, quest'ultimo la inoltra al client.
Per determinare se una risposta HTTP 5XX è stata inoltrata da un backend o se è stata generata dal proxy del bilanciatore del carico, controlla il campo statusDetails in Cloud Logging.
- Se
statusDetailsèresponse_sent_by_backend, il bilanciatore del carico ha inoltrato la risposta 5XX dal backend. Risolvi il problema sui tuoi backend. - Se
statusDetailsè un altro messaggio di errore, la risposta 5XX viene generata dal bilanciamento del carico.
Le modifiche alla configurazione del bilanciatore del carico delle applicazioni esterno globale, come l'aggiunta o la rimozione di un servizio di backend, possono comportare un breve periodo di tempo in cui vengono visualizzate risposte HTTP 502 con statusDetails come failed_to_pick_backend. Questo è
normale durante la propagazione delle modifiche alla configurazione ai
GFE a livello globale.
Prima di iniziare la risoluzione dei problemi, verifica l'integrità del backend
Prima di risolvere i problemi relativi agli errori 5XX, verifica che i backend siano integri e che i controlli di integrità vengano superati. Se i backend non sono integri, il GFE di secondo livello non può inoltrare le richieste, il che può causare errori 5XX anche se tutto il resto è configurato correttamente.
- Verifica che esista una regola firewall configurata per consentire i controlli di integrità. In assenza di uno, i controlli di integrità non riescono e i log del bilanciatore del carico potrebbero mostrare un
statusDetailsdifailed_to_pick_backend. - Verifica che il traffico del controllo di integrità raggiunga le VM di backend. Per farlo, abilita
il logging del controllo di integrità e cerca
le voci di log riuscite.
Per i nuovi bilanciatori del carico, potresti non visualizzare immediatamente le voci di log del controllo di integrità
riuscito. Ciò potrebbe essere dovuto al fatto che lo stato di integrità iniziale del backend non è ancora cambiato da
UNHEALTHYa uno diverso. Le voci di log del controllo di integrità riuscite sono visibili solo dopo che il prober del controllo di integrità riceve una risposta HTTP 200 OK dal backend.
Se i controlli di integrità non riescono, risolvi i problemi relativi all'applicazione di backend e alle regole firewall. Se i controlli di integrità vengono superati, ma continui a visualizzare errori 5XX, controlla
il campo statusDetails in Cloud Logging per identificare l'origine dell'errore, come descritto
nella sezione seguente.
Risolvere gli errori in base a statusDetails
Se gli errori HTTP 5XX persistono, utilizza il campo statusDetails in Cloud Logging
per identificare la causa e risolvere il problema di conseguenza.
Il bilanciatore del carico delle applicazioni esterno globale e il bilanciatore del carico delle applicazioni esterno regionale generano codici di stato HTTP significativi, come HTTP 503 Service Unavailable e HTTP 504 Gateway Timeout.
Il bilanciatore del carico delle applicazioni classico utilizza sempre il codice di stato HTTP 502 Bad Gateway per tutti gli errori generati dal bilanciatore del carico.
| statusDetails | Possibile causa e soluzione |
|---|---|
failed_to_pick_backendfailed_to_pick_backend_by_hash |
Causa: il GFE del secondo livello non è riuscito a selezionare un backend integro a cui indirizzare la
richiesta.
Questo errore può verificarsi per uno dei seguenti motivi:
Soluzione:
|
failed_to_connect_to_backend |
Causa: il GFE di secondo livello non è riuscito a stabilire una connessione con un'istanza di backend (non è stato possibile ottenere un SYN-ACK). Questo errore può essere causato anche da un errore GFE interno che impedisce la connessione al backend o da un'interruzione regionale o di rete (ad esempio un taglio della fibra) che impedisce ai GFE di primo livello di comunicare con i GFE di secondo livello.
Soluzione:
|
backend_connection_closed_before_data_sent_to_client |
Causa: la connessione tra il GFE del secondo livello e il backend è stata chiusa in modo imprevisto prima che la risposta potesse essere inviata al client. Questo
problema può essere causato dal server web di backend o da un dispositivo intermedio.
Può verificarsi anche quando utilizzi GKE se i
pod vengono ridimensionati o terminati e i backend del bilanciatore del carico
sono di tipo NEG.
Soluzione:
|
backend_timeout |
Causa: il GFE di secondo livello ha stabilito una connessione con il backend, ma il backend non ha inviato una risposta entro il timeout del servizio di backend configurato.
Soluzione:
|
retriable_error |
Causa:questo errore 503 può verificarsi se gli strumenti di infrastruttura come codice
(come Terraform) aggiornano le regole del bilanciatore del carico in modo da
rimuovere temporaneamente le regole della mappa URL prima di aggiungerle di nuovo oppure a causa di problemi
transitori di configurazione o di rete interna di Google durante
le implementazioni o i push di configurazione.
Soluzione:
|
Risoluzione degli errori HTTP 408
Con il traffico HTTP, il tempo massimo a disposizione del client per completare
l'invio della richiesta è pari al timeout del servizio di backend. Se visualizzi risposte HTTP 408 con jsonPayload.statusDetail client_timed_out, significa che non è stato fatto alcun progresso durante l'esecuzione del proxy della richiesta dal client o della risposta dal backend. Se il problema è dovuto a client che riscontrano problemi di prestazioni, puoi risolverlo aumentando il timeout del servizio di backend.
Il traffico con bilanciamento del carico non ha l'indirizzo di origine del client originale
L'indirizzo IP di origine per i pacchetti, come visto dai backend, non è l'indirizzo IP esterno del bilanciatore del carico. I bilanciatori del carico basati su proxy, come i bilanciatori del carico delle applicazioni esterni, utilizzano due connessioni TCP per trasmettere il traffico dal client ai backend:
- Connessione 1, dal client originale al bilanciatore del carico (GFE o subnet solo proxy)
- Connessione 2, dal bilanciatore del carico (GFE o subnet solo proxy) alla VM o all'endpoint di backend
Gli indirizzi IP di origine e di destinazione per ogni connessione variano in base al tipo di bilanciatore del carico delle applicazioni esterno che utilizzi. Per maggiori dettagli, consulta Indirizzi IP di origine per i pacchetti client .
Compare un errore di autorizzazione quando provo a visualizzare un oggetto nel mio bucket Cloud Storage
Per pubblicare oggetti tramite il bilanciamento del carico, gli oggetti Cloud Storage devono essere accessibili pubblicamente. Assicurati di aggiornare le autorizzazioni degli oggetti pubblicati in modo che siano leggibili pubblicamente.
L'URL non pubblica l'oggetto Cloud Storage previsto
L'oggetto Cloud Storage da pubblicare è determinato in base alla mappa URL e all'URL richiesto. Se il percorso della richiesta è mappato a un bucket di backend nella mappa URL, l'oggetto Cloud Storage viene determinato aggiungendo il percorso di richiesta completo al bucket Cloud Storage specificato dalla mappa URL.
Ad esempio, se mappi /static/* a gs://[EXAMPLE_BUCKET], la richiesta a
https://<GCLB IP or Host>/static/path/to/content.jpg proverà a pubblicare
gs://[EXAMPLE_BUCKET]/static/path/to/content.jpg. Se l'oggetto non esiste, riceverai il seguente messaggio di errore al posto dell'oggetto:
NoSuchKeyThe specified key does not exist.
La compressione non funziona
Un bilanciatore del carico delle applicazioni esterno non comprime né decomprime le risposte, ma può fornire risposte generate dal servizio di backend compresse utilizzando strumenti come gzip o DEFLATE.
Se le risposte gestite dal bilanciatore del carico non sono compresse, ma dovrebbero esserlo, verifica che il software del server web in esecuzione sulle tue istanze sia configurato per comprimere le risposte. Per impostazione predefinita, alcuni software dei server web disattivano automaticamente la compressione per le richieste che includono un'intestazione Via, che indica che la richiesta è stata inoltrata da un proxy. Poiché è un proxy, il bilanciatore del carico delle applicazioni esterno aggiunge un'intestazione Via a ogni richiesta come richiesto dalla specifica HTTP.
Per attivare la compressione, potresti dover sostituire la configurazione predefinita del server web per indicargli di comprimere le risposte anche se la richiesta possiede un'intestazione Via.
Per configurare i backend nginx in modo che gestiscano le risposte compresse sottoposte a proxy tramite un bilanciatore del carico delle applicazioni esterno:
- Imposta la direttiva
gzip_proxiedin modo appropriato (ad esempio, suany) e - Imposta la direttiva
gzip_varysuon.
Per configurare i backend Apache in modo che servano risposte compresse sottoposte a proxy tramite un bilanciatore del carico delle applicazioni esterno:
- Utilizza il
DEFLATEfiltro e - Aggiungi
Vary Accept-Encodingall'intestazione della risposta utilizzando il modulomod_headers.
Risolvere i problemi relativi ai backend in stato non integro
Risolvere i problemi relativi a HTTP/2 ai backend
Assicurati che l'istanza di backend sia integra e supporti il protocollo HTTP/2. Puoi verificarlo testando la connettività all'istanza di backend utilizzando HTTP/2. Assicurati che la VM utilizzi suite di crittografia conformi alle specifiche HTTP/2. Ad esempio, alcune suite di crittografia TLS 1.2 non sono consentite da HTTP/2. Fai riferimento alla lista nera delle suite di crittografia TLS 1.2.
Dopo aver verificato che la VM utilizza il protocollo HTTP/2, assicurati che la configurazione del firewall consenta il passaggio del controllo di integrità e del bilanciatore del carico.
Se non ci sono problemi con la configurazione del firewall, assicurati che il bilanciamento del carico sia configurato per comunicare con la porta corretta sulla VM.
Risolvere i problemi di gRPC
Se utilizzi lo streaming gRPC bidirezionale e il client si connette a un bilanciatore del carico delle applicazioni esterno globale, il server di backend potrebbe bloccarsi se un client esegue una chiusura immediata a metà (invia un flag END_STREAM immediatamente dopo la creazione dello stream senza inviare dati). Ciò si verifica a causa di un conflitto tra l'ottimizzazione HTTP/2 e le specifiche di framing gRPC.
Il bilanciatore del carico delle applicazioni esterno globale ottimizza il traffico HTTP/2 unendo il frame HEADERS e il frame DATA vuoto (con END_STREAM) dal client in un unico frame HEADERS con END_STREAM prima di inoltrarlo al backend.
Si tratta dell'ottimizzazione standard di HTTP/2 in base alla
RFC 7540. Il bilanciatore del carico esegue l'unione dei frame quando arrivano quasi
contemporaneamente (ritardo di 0 ms).
Alcune implementazioni del server gRPC (come grpc-go) non supportano la ricezione
del flag END_STREAM su un frame HEADERS, il che fa sì che il backend attenda
indefinitamente. La specifica gRPC su HTTP/2
richiede rigorosamente che la fine del flusso (EOS) sia indicata dal flag END_STREAM
nell'ultimo frame DATA ricevuto.
Per evitare questo problema di blocco del server di backend e la connessione rimane
aperta finché non viene terminata forzatamente dal client che invia un RST_STREAM, puoi
applicare una delle seguenti soluzioni alternative:
Introduci un piccolo ritardo (ad esempio, 10 ms o più) sul lato client prima di chiudere parzialmente lo stream. Ciò impedisce al bilanciatore del carico di unire i frame perché il frame
HEADERSè già stato inoltrato.Assicurati che il client invii almeno un messaggio di dati prima di chiudere parzialmente lo stream.
Se possibile, passa a un bilanciatore del carico delle applicazioni esterno regionale, che non unisce il frame
HEADERSe un frameDATAvuoto e li inoltra separatamente.
Risoluzione dei problemi relativi al backend esterno e ai NEG internet
Prima di esaminare i problemi, acquisisci familiarità con le seguenti pagine:
- Panoramica dei NEG internet
- Configura un bilanciatore del carico delle applicazioni esterno globale con un backend esterno (NEG internet)
- Configura un bilanciatore del carico delle applicazioni esterno regionale con un backend esterno (NEG internet)
Il traffico non raggiunge gli endpoint
Dopo aver configurato un servizio, il nuovo endpoint diventa raggiungibile tramite il bilanciatore del carico delle applicazioni esterno quando:
- L'endpoint è collegato al NEG internet.
- Il nome di dominio completo associato può essere risolto correttamente tramite DNS (se utilizzi il tipo di endpoint FQDN).
- L'endpoint è accessibile tramite internet.
Se il traffico non riesce a raggiungere l'endpoint, il che comporta un codice di errore 502, esegui una query
sul record TXT DNS _cloud-eoips.googleusercontent.com utilizzando uno strumento come dig o
nslookup. Prendi nota dei CIDR (dopo ip4:) e assicurati che questi intervalli siano consentiti
dal firewall o dall'elenco di controllo dell'accesso (ACL) al cloud.
Dopo aver configurato un backend esterno, le richieste al backend esterno non sono riuscite e hanno restituito un errore 5xx
- Seleziona Logging.
- Verifica che il gruppo di endpoint di rete sia configurato con l'IP:porta o l'FQDN:porta corretti per il tuo backend esterno.
- Se utilizzi un nome di dominio completo, assicurati che sia risolvibile tramite Google Public DNS. Puoi verificare che il nome di dominio completo sia risolvibile tramite Google Public DNS seguendo questi passaggi o utilizzando direttamente l'interfaccia web.
- Se accedi al bilanciatore del carico solo sul suo IP esterno e il tuo web server di origine prevede un nome host, assicurati di inviare un'intestazione host HTTP valida al tuo backend configurando un'intestazione della richiesta personalizzata.
- Se comunichi con un backend tramite HTTPS o HTTP2 (come impostato nel campo
protocoldel servizio di backend) configurato come endpoint di backend esternoINTERNET_FQDN_PORT, assicurati che l'origine presenti un certificato TLS (SSL) valido e che l'FQDN configurato corrisponda a un nome alternativo del soggetto (Subject Alternative Name) nell'elenco dei nomi alternativi del soggetto dei certificati. Un certificato valido è definito come un certificato firmato da un'autorità di certificazione pubblica e non scaduto. - Quando utilizzi endpoint di backend esterni
INTERNET_FQDN_PORT, i certificati autofirmati non vengono accettati dal bilanciatore del carico e vengono rifiutati. - Quando utilizzi HTTPS o HTTP/2 con endpoint di tipo
INTERNET_IP_PORT, non viene eseguita alcuna convalida del certificato SSL/controllo SAN. Ciò significa che è possibile utilizzare certificati autofirmati. Quando utilizzi SSL, ti consigliamo di utilizzare gli endpointINTERNET_FQDN_PORTper assicurarti che i certificati del server e i SAN possano essere convalidati.
Le risposte del mio backend esterno non vengono memorizzate nella cache da Cloud CDN
Assicurati che:
- Hai abilitato Cloud CDN sul servizio di backend contenente il NEG che punta al tuo backend esterno impostando enableCDN su true.
- Le risposte gestite dal backend esterno soddisfano i requisiti di memorizzazione nella cache di Cloud CDN. Ad esempio, stai inviando intestazioni di risposta
Cache-Control: public, max-age=3600dall'origine.
Risolvere i problemi relativi ai NEG serverless
Prima di esaminare i problemi, acquisisci familiarità con le seguenti pagine:
- Panoramica dei NEG serverless
- Configura un bilanciatore del carico delle applicazioni esterno globale con NEG serverless
Le richieste non vanno a buon fine e viene visualizzato un errore 404
Assicurati che la risorsa serverless sottostante (ad esempio un servizio App Engine, Cloud Run Functions o Cloud Run) sia ancora in esecuzione. Se la risorsa serverless viene eliminata, ma il NEG serverless esiste ancora, il bilanciatore del carico delle applicazioni esterno continuerà a tentare di instradare le richieste al servizio inesistente. Il risultato è una risposta 404.
In generale, un bilanciatore del carico delle applicazioni esterno non può rilevare se la risorsa serverless sottostante funziona come previsto. Ciò significa che se il tuo servizio in una regione restituisce errori, ma l'infrastruttura complessiva di Cloud Run, Cloud Run Functions o App Engine in quella regione funziona normalmente, il bilanciatore del carico delle applicazioni esterno non indirizzerà automaticamente il traffico verso altre regioni. Assicurati di testare a fondo le nuove versioni dei tuoi servizi prima di indirizzarvi il traffico degli utenti.
Gestione delle mancate corrispondenze della maschera URL
Se l'applicazione della maschera URL configurata a un URL di richiesta utente non genera un nome di servizio o se genera un nome di servizio inesistente, il bilanciatore del carico potrebbe gestire queste mancate corrispondenze in modo diverso a seconda della piattaforma di calcolo serverless in uso.
Cloud Run: in caso di mancata corrispondenza della maschera URL, il bilanciatore del carico restituisce un errore HTTP 404 (Risorsa non trovata).
Funzioni Cloud Run: in caso di mancata corrispondenza della maschera URL, il bilanciatore del carico restituisce un errore HTTP 404 (pagina non trovata).
API Gateway: in caso di mancata corrispondenza della maschera URL, il bilanciatore del carico restituisce un errore HTTP 404 (Non trovato).
App Engine: in caso di mancata corrispondenza della maschera URL, App Engine utilizza dispatch.yaml e la logica di routing predefinita di App Engine per determinare a quale servizio inviare la richiesta.
Risolvi i problemi di inserimento del gateway del tag Google
Il gateway del tag Google non inserisce i tag correttamente o causa errori.
Per risolvere il problema, utilizza Esplora log nella console Google Cloud per analizzare
i log generati dal bilanciatore del carico. I problemi del gateway dei tag Google non influiscono
sul codice di risposta HTTP complessivo o sul statusDetails della richiesta
della pagina web. La risposta HTTP verrà inviata senza modifiche anche se l'inserimento del tag Google non va a buon fine. Per identificare gli errori del gateway, controlla grpcStatus
dell'esecuzione del plug-in nel payload JSON del bilanciatore del carico.
Assicurati che Cloud Logging sia abilitato sui servizi di backend
che pubblicano i contenuti del sito web per i domini in cui Google tag
gateway è attivo. Configura questa impostazione nella console Google Cloud andando a
Bilanciamento del carico > Modifica > Configurazione backend.
Per saperne di più, consulta Abilitazione della registrazione su un servizio di backend esistente.
Per il servizio di backend deve essere impostata una frequenza di campionamento del logging superiore a 0.0.
Nella console Google Cloud , vai alla pagina Esplora log e seleziona il progetto corretto.
Modifica l'intervallo di tempo in modo che copra il periodo in cui sospetti che si siano verificati problemi. Per ulteriori informazioni, vedi Utilizzare il selettore dell'intervallo di tempo.
Per visualizzare i log delle richieste gestite dal plug-in di inserimento del gateway del tag Google, utilizza questa query:
resource.type="http_load_balancer" logName="projects/PROJECT_ID/logs/requests" \ jsonPayload.serviceExtensionInfo.extension="0-google-tag-gateway"
Sostituisci
PROJECT_IDcon l'ID progetto.Identifica i potenziali errori esaminando il campo
jsonPayload.serviceExtensionInfo.perProcessingRequestInfo.grpcStatus. Mostra lo stato dell'estensione del gateway del tag Google.OK: l'estensione ha completato l'elaborazione senza errori gRPC.- Qualsiasi valore diverso da
OK(ad esempioINTERNAL,UNAVAILABLE,DEADLINE_EXCEEDED): Indica un errore di esecuzione dell'estensione del gateway del tag Google.
Per trovare i log in cui l'estensione del gateway del tag Google ha segnalato un errore, utilizza la seguente query:
resource.type="http_load_balancer" logName="projects/PROJECT_IDlogs/requests" \ jsonPayload.serviceExtensionInfo.extension="0-google-tag-gateway" NOT jsonPayload.serviceExtensionInfo.perProcessingRequestInfo.grpcStatus="OK"
Quando la query precedente restituisce risultati, esamina l'intera voce di log per correlare lo stato dell'estensione con l'esito della richiesta:
- Errore dell'estensione del gateway del tag Google: un
grpcStatusdiverso daOK(soprattutto nell'eventoRESPONSE_BODY) indica che il processo di inserimento del tag ha rilevato un errore. Il codice gRPC specifico fornisce indizi (ad esempio,DEADLINE_EXCEEDEDindica un timeout). - Impatto sulla richiesta dell'utente: se
grpcStatusper l'estensione gateway del tag Google non èOK, controllahttpRequest.statusejsonPayload.statusDetailsnella stessa voce di log. Ad esempio, unOKnongrpcStatuscombinato conhttpRequest.status: 500ejsonPayload.statusDetails: service_extensions_errorsuggerisce che l'errore dell'estensione gateway del tag Google ha causato la ricezione di un errore del server da parte dell'utente. - Frequenza dei problemi: l'analisi dei timestamp e della frequenza di questi log degli errori consente di determinare se i problemi di inserimento del gateway dei tag Google sono in corso, intermittenti o legati a eventi specifici.
- Errore dell'estensione del gateway del tag Google: un
Se riscontri problemi durante la configurazione che la documentazione non riesce a risolvere, contatta l'assistenza Google Ads.