In questa pagina vengono spiegati i vari problemi, i relativi messaggi di errore e i passaggi per la risoluzione dei problemi.
Problemi di connettività
Se l'istanza Memorystore for Redis presenta problemi di connettività, controlla i problemi in questa sezione per vedere se uno di questi è la causa del problema.
Se un problema in questa sezione non corrisponde al tuo, utilizza Telnet per connetterti a uno dei tuoi nodi Redis ed esegui alcuni comandi Redis per verificare se l'istanza risponde.
Se il nodo non risponde, controlla se uno dei problemi di rete è il motivo per cui la connessione di rete del nodo è bloccata. Se nessuno di questi problemi risolve il problema, contatta l'assistenza clienti Google Cloud.
Esegui il provisioning delle risorse in reti VPC diverse.
Per connetterti a un'istanza Memorystore for Redis da una risorsa Google Cloud , ad esempio una VM di Compute Engine, devi eseguire il provisioning delle risorse sulla stessa rete VPC autorizzata dell'istanza.
Il tentativo di connettersi tramite Telnet a un'istanza da una risorsa che si trova in una regione o in una rete VPC diversa genera il seguente messaggio di errore:
telnet: Unable to connect to remote host: Connection timed out
Elimini un peering di rete VPC.
Quando crei un'istanza Memorystore for Redis, crei un peering VPC tra la tua rete VPC e una rete VPC Google interna.
Il peering di rete utilizza il seguente formato:
redis-peer-############
Se questo peering di rete viene eliminato, il tentativo di connessione Telnet all'istanza genera il seguente messaggio di errore:
telnet: Unable to connect to remote host: Connection timed out
Per ristabilire il peering di rete eliminato, crea un'altra istanza. Poi, elimina l'istanza. L'istanza originale ora ha il peering di rete di cui ha bisogno.
Crei regole firewall che bloccano gli indirizzi IP della tua istanza.
Se crei regole firewall in uscita che bloccano la porta (6379) o l'indirizzo IP dell'istanza Memorystore for Redis, potresti riscontrare problemi di connettività. Non creare regole firewall di rete che bloccano l'intervallo di indirizzi IP della tua istanza.
Hai connessioni che non rispondono
Ti consigliamo vivamente di configurare l'applicazione client in modo che rilevi le connessioni non reattive a Memorystore for Redis. Quando viene rilevata una connessione che non risponde, il client deve reimpostarla. Per creare un'applicazione resiliente, ti consigliamo le seguenti configurazioni client:
- Configura i parametri TCP keep-alive: imposta i parametri
TCP keepalive time,TCP keepalive intervaleTCP keepalive probesin modo che i client rilevino e interrompano in modo proattivo le connessioni che non rispondono, anche quando sono inattive. Ad esempio, se imposti il parametroTCP keepalive timesu 30 secondi,TCP keepalive intervalsu 10 secondi eTCP keepalive probessu 3, i client reimpostano le connessioni inattive che non rispondono entro un minuto. - Configura i timeout utente TCP: imposta questo timeout nei client per reimpostare le connessioni con richieste in sospeso e interrompere la risposta. Ad esempio, se imposti il timeout su 15 secondi, i client reimpostano le connessioni che non rispondono e che hanno richieste in sospeso dopo 15 secondi.
Memorystore for Redis rifiuta i nuovi tentativi di connessione
Quando attivi la crittografia in transito, ogni livello di capacità di Memorystore for Redis applica un limite massimo di connessioni. Se l'istanza raggiunge questo limite, Memorystore for Redis rifiuta i nuovi tentativi di connessione.
Per risolvere questo problema, procedi in uno dei seguenti modi:
- Fai lo scale up dell'istanza a un livello di capacità che supporti il numero di connessioni richiesto
- Riduci il numero totale di connessioni stabilendo e riutilizzando connessioni a lunga esecuzione
Puoi monitorare il numero di connessioni attive utilizzando la metrica redis.googleapis.com/clients/connected. Se Memorystore for Redis rifiuta i nuovi tentativi di connessione, ma il numero di connessioni è inferiore al limite massimo, controlla i log lato client (ad esempio i log stunnel) per verificare la presenza di errori.
Memorystore for Redis interrompe le connessioni esistenti
Per le istanze che eseguono Redis versione 6.x o precedente con la crittografia dei dati in transito abilitata, Memorystore for Redis ruota i certificati lato server ogni 180 giorni. Questa rotazione può causare l'interruzione delle connessioni dell'istanza per alcuni secondi.
Per risolvere il problema, configura l'applicazione client in modo che si riconnetta automaticamente riprovando le connessioni con backoff esponenziale. Se esegui l'upgrade dell'istanza a Redis versione 7.0 o successive, Memorystore for Redis non interrompe le connessioni quando ruota i certificati.
Problemi di utilizzo della CPU
Questa sezione spiega i problemi di utilizzo della CPU che l'istanza Memorystore for Redis potrebbe riscontrare.
L'istanza riscontra una latenza elevata o non risponde.
Se l'istanza Memorystore for Redis presenta una latenza elevata o non risponde, questi problemi potrebbero essere causati dall'utilizzo dei seguenti comandi Redis ad alta intensità di risorse:
Questi comandi possono esercitare una forte pressione sulla CPU dell'istanza. Ti consigliamo di non eseguire il comando KEYS negli ambienti di produzione. Utilizza invece SCAN, perché questo comando utilizza meno risorse di KEYS.
L'utilizzo di LRANGE per eseguire query su tutto o su un ampio sottoinsieme del keyspace può richiedere risorse CPU elevate. Per risolvere il problema, ti consigliamo di ridurre il numero di chiavi
nel set di chiavi su cui esegui query in un'unica operazione.
Anche l'utilizzo di uno script Lua complesso con EVAL può causare un utilizzo elevato della CPU. Ti consigliamo di utilizzare script Lua meno complessi.
HGETALL e ZRANGE possono restituire un numero elevato di chiavi, con un impatto negativo sulle prestazioni del server. Anziché HGETALL, ti consigliamo di eseguire il comando HSCAN. Inoltre, prima di utilizzare ZRANGE, ti consigliamo di limitare le dimensioni dell'intervallo che utilizzi per una query.
Prima di eseguire un comando che richiede un utilizzo intensivo delle risorse, controlla le dimensioni delle strutture di dati su cui il comando esegue query per assicurarti che non causi latenza.
Se l'istanza presenta una latenza elevata o non risponde, procedi nel seguente modo:
- Controlla i log lato client per scoprire se sono stati eseguiti comandi che richiedono molte risorse. In questo caso, prendi nota della data e dell'ora.
- Utilizza Cloud Monitoring per visualizzare la metrica
redis.googleapis.com/stats/cpu_utilization. Controlla se i periodi di utilizzo elevato della CPU coincidono con gli stessi periodi in cui sono stati eseguiti i comandi ad alta intensità di risorse.
Lo spazio nel buffer di output dell'istanza si esaurisce.
Se il buffer di output dell'istanza Memorystore for Redis esaurisce lo spazio, procedi nel seguente modo:
- Imposta un valore inferiore per il parametro
maxmemory-gb. - Utilizza la policy
maxmemoryallkeys-lru.
Quando la memoria dell'istanza è piena e viene eseguita una nuova scrittura, Memorystore for Redis rimuove le chiavi per fare spazio alla scrittura, in base alla policy maxmemory dell'istanza. La policy allkeys-lru rimuove le chiavi utilizzate meno di recente (LRU) dall'intero set di chiavi.
Ti consigliamo di monitorare la maxmemory e la memoria utilizzata dell'istanza. In questo modo, puoi sapere se l'istanza raggiunge la capacità di istanze di cui è stato eseguito il provisioning.
Inoltre, riducendo il valore del parametro maxmemory-gb, ottieni più spazio per l'overhead.
Mancano le metriche esterne per la tua istanza
Se l'istanza registra un utilizzo elevato della CPU o se le risorse dell'istanza si esauriscono (ad esempio, a causa di un numero eccessivo di connessioni), l'istanza potrebbe non funzionare correttamente e le metriche esterne potrebbero non essere disponibili.
Isola l'origine della latenza dell'istanza
Per determinare se la latenza che riscontri proviene dalla tua istanza, dalla tua applicazione client o dal tuo ambiente di rete, utilizza lo strumento redis-cli per eseguire un test di latenza continuo.
Per isolare l'origine della latenza dell'istanza, segui questi passaggi:
Connettiti a una VM di Compute Engine che si trova nella stessa regione e nella stessa rete VPC della tua istanza.
Se non è già installato, installa lo strumento
redis-clisulla VM.Per le VM basate su Debian o Ubuntu, esegui il seguente comando:
sudo apt-get install redis-toolsPer le VM basate su RHEL o CentOS, esegui questo comando:
sudo yum install redis
Per misurare la latenza dell'istanza in millisecondi, esegui questo comando:
redis-cli --latency -h IP_ADDRESS -p PORT
Se per l'istanza è abilitata l'autenticazione Redis o la crittografia dei dati in transito, assicurati di aggiungere i flag di autenticazione (
-a) o TLS (--tls) richiesti.Effettua le seguenti sostituzioni:
- IP_ADDRESS: l'indirizzo IP della tua istanza.
- PORT: il numero di porta riservato alla tua istanza. In genere, questo numero di porta è 6379.
Lascia che il comando venga eseguito per alcuni minuti. Lo strumento invia continuamente ping al server e calcola i valori di latenza minima, massima e media.
Per interrompere il comando e visualizzare i risultati, premi
Ctrl+C.
Se il comando restituisce una latenza media costantemente bassa (in genere 1 millisecondo o meno), l'istanza è in stato integro e risponde rapidamente.
Se il comando mostra una latenza costantemente bassa, ma l'applicazione client continua a subire ritardi, la latenza potrebbe essere causata dai seguenti problemi:
- Rete: il traffico instradato tra regioni o zone diverse tra il client e l'istanza potrebbe introdurre ritardi di rete significativi.
- Client: un utilizzo elevato della CPU o della memoria sul client, pool di connessioni esauriti o colli di bottiglia della logica dell'applicazione potrebbero aumentare il tempo di round trip totale riscontrato dal client.
Problemi di networking
Questa sezione illustra i problemi di networking che la tua istanza potrebbe riscontrare.
Esaurisci l'intervallo IP allocato o esiste una route in conflitto.
Quando crei risorse all'interno dell'intervallo di indirizzi IP dedicato a Memorystore for Redis, potresti esaurire tutti gli indirizzi IP. In alternativa, potrebbe esserci una route in conflitto con l'indirizzo IP dell'istanza Memorystore for Redis che stai tentando di creare.
Questi problemi causano la visualizzazione del seguente messaggio di errore:
The IP ranges for the connection do not have enough available IPs. Allocate a
new range or expand existing range and try again.
Per risolvere il problema, alloca indirizzi IP aggiuntivi o rimuovi la discrepanza del conflitto di route. Per saperne di più, consulta Esaurimento dell'intervallo di indirizzi IP.
Non hai stabilito una connessione di accesso privato ai servizi per la tua rete.
Se l'istanza Memorystore for Redis utilizza la modalità di connessione di accesso privato ai servizi, ma non esiste una connessione di accesso privato ai servizi per la tua rete, potresti ricevere il seguente messaggio di errore:
Google private service access is not enabled. Enable private service access and
try again
Per risolvere il problema, stabilisci una connessione di accesso privato ai servizi.
Elimini il peering di rete per la connessione di accesso privato ai servizi.
Quando stabilisci una connessione di accesso privato ai servizi, Memorystore for Redis crea una connessione di peering di rete denominata servicenetworking-googleapis-com. Questa connessione viene visualizzata nella pagina Peering di rete VPC del progetto.
Se elimini il peering di rete, viene visualizzato il seguente messaggio di errore per le istanze esistenti:
telnet: Unable to connect to remote host: Connection timed out
Inoltre, se elimini il peering di rete e crei un'istanza, viene visualizzato il seguente messaggio di errore:
Private services access is not configured correctly. For steps on how to
verify the connection, check the documentation.
Per risolvere il problema, crea una connessione di accesso privato ai servizi tra la tua rete e la rete di accesso privato ai servizi eseguendo questo comando:
gcloud services vpc-peerings connect --service=servicenetworking.googleapis.com --ranges=RESERVED_RANGE_NAME --network=VPC_NETWORK --project=PROJECT_ID
Utilizzi parametri in conflitto.
Se utilizzi sia il parametro --reserved-ip-range sia il parametro --connect-mode=private-service-access, viene visualizzato il seguente messaggio di errore:
Reserved IP range is not supported for --connect-mode private services access
Non puoi utilizzare entrambi i parametri contemporaneamente perché Memorystore for Redis non supporta il parametro --reserved-ip-range per la modalità di connessione con accesso privato ai servizi.
Per risolvere questo problema, procedi in uno dei seguenti modi:
- Utilizza il parametro
--reserved-ip-rangecon il parametro--connect-mode=direct-peering. - Non utilizzare il parametro
--reserved-ip-range.
Superi la quota di subnet per il tuo progetto.
Esiste un limite al numero di subnet che puoi creare all'interno del tuo progettoGoogle Cloud . Se superi questa quota, riceverai uno dei seguenti messaggi di errore:
Internal network quota exceeded. Please request higher limit here: https://forms.gle/ZfVduUGq2iSYcYGm8
o
Unable to create instance. Network quota limit has been reached. Please request higher limit here: https://forms.gle/ZfVduUGq2iSYcYGm8
Per risolvere il problema, compila il modulo visualizzato nei messaggi di errore o contatta l'assistenza clienti Google Cloud.
Non colleghi il progetto di servizio al progetto host.
Se utilizzi un VPC condiviso e non colleghi il progetto di servizio al progetto host, ricevi il seguente messaggio di errore:
Invalid network name <network-name>. Project <project-name> referenced is not the host project for <service-project-name>.
Per risolvere il problema, collega il progetto di servizio al progetto host.
Crei un'istanza in un progetto di servizio con la modalità di connessione in peering diretto e designi una rete VPC condiviso.
Se crei un'istanza Memorystore for Redis in un progetto di servizio e designi una rete VPC condiviso dal progetto host per l'istanza, non puoi utilizzare la modalità di connessione con peering diretto.
Per impostazione predefinita, la modalità di connessione è impostata su Peering diretto. Se provi a utilizzare questa modalità di connessione quando crei un'istanza e scegli anche una rete VPC condiviso dal progetto host come valore per il parametro --network, ricevi il seguente messaggio di errore:
Authorized_network must exist in the same project as redis instance
Per risolvere questo problema, procedi in uno dei seguenti modi:
- Quando crei l'istanza, utilizza la modalità di connessione di accesso privato ai servizi
(--connect-mode=private-service-access). - Scegli una rete VPC autorizzata che si trova nello stesso progetto della tua istanza.
Utilizzi un intervallo di indirizzi IP per Compute Engine a cui Memorystore for Redis non può accedere.
Non puoi accedere all'istanza Memorystore for Redis da una VM di Compute Engine con un indirizzo IP nell'intervallo 172.17.0.0/16.
Questo intervallo è riservato a un componente interno.
Per risolvere il problema, accedi all'istanza da una VM di Compute Engine con un indirizzo IP in un intervallo diverso.
Problemi di connessione all'istanza da altre risorse Google Cloud
Questa sezione spiega i problemi che l'istanza Memorystore for Redis potrebbe riscontrare quando altre risorse tentano di connettersi.
Non puoi connetterti alla tua istanza da ambienti serverless che richiedono un connettore di accesso VPC serverless
Se non riesci a connetterti alla tua istanza Memorystore for Redis utilizzando uno degli ambienti serverless che richiedono un connettore di accesso VPC serverless, verifica se hai configurato questo connettore per il tuo ambiente. Per saperne di più, consulta Requisito del connettore di accesso VPC serverless.
Non riesci a connetterti alla tua istanza da un cluster Google Kubernetes Engine (GKE)
Per connetterti all'istanza Memorystore for Redis da un cluster GKE, devi abilitare l'aliasing IP/VPC nativo sul cluster.
Il modo più semplice per abilitare l'aliasing IP/nativo di VPC è farlo durante la creazione del cluster. Nella sezione delle opzioni avanzate, seleziona VPC nativo. Per saperne di più, consulta Crea un cluster nativo di VPC.
Problemi di Identity and Access Management (IAM)
Questa sezione spiega i problemi IAM che l'istanza Memorystore for Redis potrebbe riscontrare.
Vuoi ripristinare un'associazione di policy eliminata per un account di servizio
Memorystore for Redis utilizza i seguenti service account per gestire le tue istanze:
service-PROJECT_NUMBER@service-networking.service-PROJECT_NUMBER@cloud-redis.
Se elimini le associazioni delle policy per questi service account, non potrai creare istanze.
Se provi a creare un'istanza Memorystore for Redis utilizzando Google Cloud CLI, potresti ricevere il seguente messaggio di errore:
(gcloud.redis.instances.create) FAILED_PRECONDITION: A required IAM policy might be missing. Please run this command:"gcloud projects add-iam-policy-binding YOUR_PROJECT_ID --member='serviceAccount:service-YOUR_PROJECT_NUMBER@cloud-redis.' --role='roles/redis.serviceAgent'" and try again.
Per ristabilire l'associazione della policy per il account di servizio service-networking, esegui questo comando. Sostituisci VARIABLES con i valori appropriati.
gcloud projects add-iam-policy-binding PROJECT_ID --member='serviceAccount:service-PROJECT_NUMBER@service-networking.' --role='roles/servicenetworking.serviceAgent'
Per ristabilire l'associazione della policy per il account di servizio cloud-redis, esegui il seguente comando. Sostituisci VARIABLES con i valori appropriati.
gcloud projects add-iam-policy-binding PROJECT_ID --member='serviceAccount:service-PROJECT_NUMBER@cloud-redis.' --role='roles/redis.serviceAgent'
Problemi di timeout delle operazioni
I seguenti problemi causano la mancata risposta di un'istanza Redis e/o timeout delle operazioni dell'istanza/del nodo.
Problemi di partizione di rete
A volte le risorse Google Cloud non possono comunicare tra zone all'interno di una regione a causa di un errore di partizione di rete nei server Google Cloud. Ciò può causare la perdita della connessione dell'istanza, con conseguente errore di timeout.
Dopo che Google Cloud ha risolto l'errore di partizione di rete per la regione o la zona in cui è stato eseguito il provisioning dell'istanza, la connettività dovrebbe riprendere normalmente.
In questo caso, potresti visualizzare un messaggio di errore di connettività come il seguente:
telnet: Unable to connect to remote host: Connection timed out
Se non riesci a identificare la causa dell'errore di timeout, contatta l'assistenzaGoogle Cloud .
Il progetto di servizio e il progetto host non si trovano nello stesso perimetro dei Controlli di servizio VPC
Se utilizzi un VPC condiviso e un perimetro dei Controlli di servizio VPC e l'operazione di creazione dell'istanza Redis scade, ciò potrebbe indicare che il progetto di servizio e il progetto host non si trovano nello stesso perimetro di servizio. Il progetto di servizio e il progetto host devono trovarsi nello stesso perimetro affinché l'istanza Redis possa comunicare con i client di connessione tramite la rete VPC condiviso.
Per verificare se stai riscontrando questo problema, controlla gli audit log dell'istanza Redis per il seguente errore:
violationReason: "NETWORK_NOT_IN_SAME_SERVICE_PERIMETER"
Per risolvere il problema, inserisci la rete host e la rete di servizi nello stesso perimetro di servizio.
Risoluzione dei problemi di importazione ed esportazione
Questa sezione descrive alcuni problemi comuni che potresti riscontrare durante l'utilizzo dell'importazione e dell'esportazione per Memorystore for Redis.
I pulsanti Importa ed Esporta sono disattivati nella console Google Cloud
Problema: l'utente che ha eseguito l'accesso alla console non dispone delle autorizzazioni redis.instances.import e/o redis.instances.export necessarie per importare e/o esportare i file RDB.
Soluzione: concedi le autorizzazioni all'utente e aggiorna la pagina dei dettagli dell'istanza.
L'operazione di importazione è stata completata, ma i dati non sono stati ripristinati
Se un'operazione di importazione viene completata, ma i dati non vengono ripristinati, controlla innanzitutto la console Google Cloud o la riga di comando per verificare la presenza di un messaggio di errore e risolvi eventuali problemi descritti nel messaggio di errore.
Se si verifica un errore durante il processo di importazione, l'istanza viene recuperata utilizzando un file RDB vuoto. Puoi provare a ripristinare i dati importando nuovamente lo stesso file RDB o utilizzando un file RDB diverso.
L'importazione non è riuscita perché il file RDB era troppo grande
Se hai ricevuto il messaggio di errore "Import RDB file gs://bucket/object.rdb size exceeds max memory 10GB", devi fare lo scale up dell'istanza e riprovare l'importazione. Puoi anche provare a importare un file RDB più piccolo nell'istanza.
Risoluzione dei problemi di Google Cloud CLI
Se riscontri un problema per cui un comando gcloud CLI non è disponibile o se il comando si comporta in modo diverso da come è documentato, prova ad aggiornare gcloud CLI:
gcloud components update
Arresto di tutti i comandi e le connessioni in corso per un'istanza Redis
Poiché Memorystore for Redis è un prodotto gestito da Google, alcuni comandi sono bloccati nell'istanza Redis per fornire un ambiente sicuro e affidabile. Uno dei comandi limitati è CLIENT, che include CLIENT KILL, utilizzato per interrompere i comandi.
Se un comando Redis consuma molta CPU/RAM e influisce sul tuo ambiente di produzione, devi riavviare l'istanza (per le configurazioni di livello Base) o eseguire il failover in una replica (per le configurazioni di livello Standard). Questa operazione di riavvio/failover interrompe tutti i comandi in esecuzione sul server Redis e termina tutte le connessioni in corso.
Di seguito sono riportati i comandi per eseguire i riavvii o i failover per ogni configurazione di Memorystore for Redis.
Comandi di arresto nelle istanze Memorystore for Redis di livello Standard
gcloud redis instances failover INSTANCE_NAME --data-protection-mode=limited-data-loss
Arresto dei comandi nelle istanze Memorystore for Redis di livello Base
L'unico modo per eseguire un riavvio in un'istanza Memorystore for Redis è modificare la configurazione, ad esempio fare lo scale up dell'istanza. Di seguito è riportato un esempio di comando che puoi eseguire per riavviare l'istanza.
gcloud redis instances update INSTANCE_NAME --region REGION_ID --size NUMBER_GB
Dopo aver scalato l'istanza a una dimensione diversa, puoi eseguire un'altra operazione di scalabilità per riportarla alle dimensioni originali.
Problemi relativi alle policy dell'organizzazione con la limitazione del dominio per la condivisione
Esiste un problema noto per cui la policy dell'organizzazione iam.allowedPolicyMemberDomains causa errori quando viene utilizzata con le istanze Memorystore for Redis che utilizzano il formato del account di servizio PROJECT_NUMBER-compute@.
A seconda di quando è stata creata l'istanza, Memorystore for Redis utilizza uno dei due diversi formati di account di servizio. Per identificare il formato del service account della tua istanza, consulta Formato del account di servizio Memorystore for Redis.
Quando si verifica questo problema, potresti visualizzare il seguente messaggio di errore: One or
more users named in the policy do not belong to a permitted customer.
A seconda delle policy della tua organizzazione e della possibilità di ricreare l'istanza, puoi risolvere questo errore utilizzando una delle seguenti opzioni:
Ricrea l'istanza: le istanze meno recenti utilizzano il formato account di servizio
PROJECT_NUMBER-compute@, che spesso viene bloccato dalle policy di condivisione con limitazioni del dominio. Le istanze appena create utilizzano un formato di account di servizio moderno compatibile con la maggior parte delle policy dell'organizzazione.Se la policy dell'organizzazione blocca tutti i domini esterni, questa opzione non funziona. Per bypassare la policy, devi utilizzare la seconda opzione.
Forza l'accesso all'account: se non riesci a ricreare l'istanza per ottenere il nuovo formato del account di servizio o se la policy della tua organizzazione blocca il nuovo dominio del service account, devi bypassare la policy forzando l'accesso all'account per il tuo progetto. Per saperne di più, consulta Forzare l'accesso all'account.