Nesta página, explicamos vários problemas, as mensagens de erro deles e as etapas de solução de problemas para resolvê-los.
Problemas de conectividade
Se a instância do Memorystore para Redis tiver problemas de conectividade, verifique os problemas nesta seção para ver se um deles é a causa.
Se um problema nesta seção não corresponder ao seu, use o Telnet em um dos nós do Redis e execute alguns comandos do Redis para ver se a instância responde.
Se o nó não estiver respondendo, verifique se algum dos problemas de rede é o motivo pelo qual a conexão de rede do nó está bloqueada. Se nenhuma dessas soluções resolver o problema, entre em contato com o Cloud Customer Care.
Você provisiona recursos em diferentes redes VPC.
Para se conectar a uma instância do Memorystore para Redis de um recurso do Google Cloud , como uma VM do Compute Engine, é preciso provisionar os recursos na mesma rede VPC autorizada que a instância.
A tentativa de usar o Telnet em uma instância de um recurso que está em uma região ou rede VPC diferente resulta na seguinte mensagem de erro:
telnet: Unable to connect to remote host: Connection timed out
Você exclui um peering de rede VPC.
Ao criar uma instância do Memorystore para Redis, você cria um peering de VPC entre sua rede VPC e uma rede VPC interna do Google.
O peering de rede usa o formato a seguir:
redis-peer-############
Se esse peering de rede for excluído, a tentativa de usar o Telnet na instância vai resultar na seguinte mensagem de erro:
telnet: Unable to connect to remote host: Connection timed out
Para restabelecer o peering de rede excluído, crie outra instância. Em seguida, exclua essa instância. Sua instância original agora tem o peering de rede necessário.
Você cria regras de firewall que bloqueiam os endereços IP da instância.
Se você criar regras de firewall de saída que bloqueiem a porta (6379) ou o endereço IP da instância do Memorystore para Redis, talvez ocorram problemas de conectividade. Não crie regras de firewall de rede que bloqueiem o intervalo de endereços IP da instância.
Você tem conexões que não respondem
Recomendamos configurar o aplicativo cliente para detectar conexões que não respondem ao Memorystore para Redis. Quando uma conexão que não responde é detectada, o cliente precisa redefini-la. Para criar um aplicativo resiliente, recomendamos as seguintes configurações de cliente:
- Configure os parâmetros de sinal de atividade do TCP: defina os parâmetros
TCP keepalive time,TCP keepalive intervaleTCP keepalive probespara que os clientes detectem e descartem conexões que não respondem de maneira proativa, mesmo quando as conexões estão inativas. Por exemplo, se você definir o parâmetroTCP keepalive timecomo 30 segundos,TCP keepalive intervalcomo 10 segundos eTCP keepalive probescomo 3, os clientes vão redefinir as conexões inativas que não respondem em um minuto. - Configurar tempos limite do usuário de TCP: defina esse tempo limite nos clientes para redefinir conexões que têm solicitações pendentes e param de responder. Por exemplo, se você definir o tempo limite como 15 segundos, os clientes vão redefinir as conexões que não respondem e que têm solicitações pendentes após 15 segundos.
O Memorystore para Redis rejeita novas tentativas de conexão
Quando você ativa a criptografia em trânsito, cada nível de capacidade do Memorystore para Redis impõe um limite máximo de conexões. Se a instância atingir esse limite, o Memorystore para Redis vai rejeitar novas tentativas de conexão.
Para resolver o problema, siga um destes procedimentos:
- Escalone sua instância para um nível de capacidade que ofereça suporte ao número necessário de conexões.
- Diminua o número total de conexões estabelecendo e reutilizando conexões de longa duração.
É possível monitorar a contagem de conexões ativas usando a métrica redis.googleapis.com/clients/connected. Se o
Memorystore para Redis rejeitar novas tentativas de conexão, mas sua contagem de conexões
for menor que o limite máximo, verifique se há erros nos registros do lado do cliente (como
registros do stunnel).
O Memorystore for Redis descarta as conexões atuais
Para instâncias que executam a versão 6.x ou anterior do Redis com a criptografia em trânsito ativada, o Memorystore para Redis alterna os certificados do lado do servidor a cada 180 dias. Essa rotação pode fazer com que a instância perca conexões por alguns segundos.
Para resolver esse problema, configure o aplicativo cliente para se reconectar automaticamente, repetindo as conexões com espera exponencial. Se você fizer upgrade da instância para a versão 7.0 ou posterior do Redis, o Memorystore for Redis não vai descartar as conexões ao alternar os certificados.
Problemas de uso da CPU
Nesta seção, explicamos os problemas de uso da CPU que sua instância do Memorystore para Redis pode encontrar.
Sua instância apresenta alta latência ou não responde.
Se a instância do Memorystore para Redis apresentar alta latência ou não responder, esses problemas podem ser causados pelo uso dos seguintes comandos do Redis que consomem muitos recursos:
Esses comandos podem sobrecarregar a CPU na instância. Recomendamos que
você não execute o comando KEYS em ambientes de produção. Em vez disso, use
SCAN, porque esse comando usa menos recursos do que KEYS.
Usar LRANGE para consultar todo o keyspace ou um grande subconjunto dele pode exigir muitos recursos de CPU. Para resolver isso, recomendamos reduzir o número de chaves
no conjunto de chaves que você consulta em uma única operação.
O uso de um script Lua complexo com EVAL também pode causar alto uso da CPU. Recomendamos
que você use scripts Lua menos complexos.
HGETALL e ZRANGE podem retornar um grande número de chaves, afetando negativamente o desempenho do servidor. Em vez de HGETALL, recomendamos
que você execute o comando HSCAN. Além disso, antes de usar ZRANGE, recomendamos que
você limite o tamanho do intervalo usado para uma consulta.
Antes de executar um comando que consome muitos recursos, verifique o tamanho das estruturas de dados consultadas pelo comando para garantir que ele não cause latência.
Se a instância apresentar alta latência ou não responder, faça o seguinte:
- Verifique os registros do lado do cliente para descobrir se algum comando que consome muitos recursos foi executado. Se sim, anote a data e a hora.
- Use o Cloud Monitoring para
visualizar a métrica
redis.googleapis.com/stats/cpu_utilization. Verifique se os períodos de alta utilização da CPU coincidem com os mesmos períodos em que os comandos que consomem muitos recursos foram executados.
O buffer de saída da instância fica sem espaço.
Se o buffer de saída da instância do Memorystore para Redis ficar sem espaço, faça o seguinte:
- Defina um valor menor para o parâmetro
maxmemory-gb. - Use a política
maxmemorydoallkeys-lru.
Quando a memória da instância está cheia e uma nova gravação é recebida,
o Memorystore para Redis remove as chaves para abrir espaço para a gravação, com base na
política maxmemory da instância. A política allkeys-lru remove as chaves usadas menos recentemente (LRU, na sigla em inglês) de todo o conjunto de chaves.
Recomendamos que você monitore a maxmemory e a memória usada da instância. Isso
ajuda a saber se a instância atingiu a capacidade provisionada.
Além disso, ao reduzir o valor do parâmetro maxmemory-gb, você ganha mais espaço
para a sobrecarga.
As métricas externas estão ausentes na sua instância
Se a instância tiver alta utilização de CPU ou se os recursos dela forem esgotados (por exemplo, por ter muitas conexões), ela poderá se comportar de maneira inadequada e as métricas externas poderão estar ausentes.
Isolar a origem da latência da instância
Para determinar se a latência que você está enfrentando se origina da
sua instância, do seu aplicativo cliente ou do seu ambiente de rede, use a
ferramenta redis-cli para executar um teste de latência contínuo.
Para isolar a origem da latência da instância, faça o seguinte:
Conecte-se a uma VM do Compute Engine localizada na mesma região e rede VPC que sua instância.
Se ainda não estiver instalada, instale a ferramenta
redis-clina VM.Para VMs baseadas em Debian ou Ubuntu, execute o seguinte comando:
sudo apt-get install redis-toolsPara VMs baseadas em RHEL ou CentOS, execute o seguinte comando:
sudo yum install redis
Para medir a latência da instância em milissegundos, execute o seguinte comando:
redis-cli --latency -h IP_ADDRESS -p PORT
Se a instância tiver a autenticação do Redis ou a criptografia em trânsito ativada, adicione as flags de autenticação (
-a) ou TLS (--tls) necessárias.Faça as seguintes substituições:
- IP_ADDRESS: o endereço IP da instância.
- PORT: o número da porta reservada para a instância. Normalmente, esse número de porta é 6379.
Deixe o comando em execução por alguns minutos. A ferramenta faz ping continuamente no servidor e calcula os valores de latência mínimo, máximo e médio.
Para interromper o comando e ver os resultados, pressione
Ctrl+C.
Se a resposta ao comando gerar uma latência média consistentemente baixa (normalmente 1 milissegundo ou menos), a instância estará íntegra e respondendo rapidamente.
Se o comando mostrar uma latência consistentemente baixa, mas o aplicativo cliente ainda tiver atrasos, os seguintes problemas poderão causar a latência:
- Rede: o tráfego roteado entre diferentes regiões ou zonas entre o cliente e a instância pode causar atrasos significativos na rede.
- Cliente: o uso elevado de CPU ou uso da memória no cliente, os pools de conexão esgotados ou os gargalos de lógica do aplicativo podem aumentar o tempo de retorno total que o cliente experimenta.
Problemas de rede
Nesta seção, explicamos os problemas de rede que sua instância pode encontrar.
Você esgotar o intervalo de IP alocado ou houver uma rota conflitante.
Ao criar recursos dentro do intervalo de endereços IP dedicado ao Memorystore para Redis, é possível que todos os endereços IP sejam esgotados. Ou pode haver uma rota que entra em conflito com o endereço IP da instância do Memorystore for Redis que você está tentando criar.
Esses problemas fazem com que a seguinte mensagem de erro apareça:
The IP ranges for the connection do not have enough available IPs. Allocate a
new range or expand existing range and try again.
Para resolver esse problema, aloque mais endereços IP ou remova a discrepância de conflito de rota. Para mais informações, consulte Exaustão do intervalo de endereços IP.
Não há uma conexão de acesso a serviços particulares estabelecida para sua rede.
Se a instância do Memorystore para Redis usar o modo de conexão de acesso a serviços particulares, mas não houver uma conexão de acesso a serviços particulares para sua rede, talvez você receba a seguinte mensagem de erro:
Google private service access is not enabled. Enable private service access and
try again
Para resolver esse problema, estabeleça uma conexão de acesso a serviços privados.
Exclua o peering de rede da conexão de acesso a serviços particulares.
Quando você estabelece uma conexão de acesso a serviços particulares, o Memorystore para Redis cria uma conexão de peering de rede chamada servicenetworking-googleapis-com. Essa conexão aparece na página Peering de rede VPC do projeto.
Se você excluir o peering de rede, a seguinte mensagem de erro será exibida para as instâncias atuais:
telnet: Unable to connect to remote host: Connection timed out
Além disso, se você excluir o peering de rede e criar uma instância, a seguinte mensagem de erro será exibida:
Private services access is not configured correctly. For steps on how to
verify the connection, check the documentation.
Para resolver esse problema, crie uma conexão de acesso a serviços particulares entre sua rede e a rede de acesso a serviços particulares executando o seguinte comando:
gcloud services vpc-peerings connect --service=servicenetworking.googleapis.com --ranges=RESERVED_RANGE_NAME --network=VPC_NETWORK --project=PROJECT_ID
Você usa parâmetros conflitantes.
Se você usar os parâmetros --reserved-ip-range e --connect-mode=private-service-access,
vai receber a seguinte mensagem de erro:
Reserved IP range is not supported for --connect-mode private services access
Não é possível usar os dois parâmetros ao mesmo tempo porque o Memorystore para Redis
não é compatível com o parâmetro --reserved-ip-range para o modo de conexão de acesso a serviços
privados.
Para resolver o problema, siga um destes procedimentos:
- Use o parâmetro
--reserved-ip-rangecom o parâmetro--connect-mode=direct-peering. - Não use o parâmetro
--reserved-ip-range.
Você excedeu a cota de sub-redes do seu projeto.
Há um limite para o número de sub-redes que podem ser criadas no projeto do Google Cloud . Se você exceder essa cota, vai receber uma das seguintes mensagens de erro:
Internal network quota exceeded. Please request higher limit here: https://forms.gle/ZfVduUGq2iSYcYGm8
ou
Unable to create instance. Network quota limit has been reached. Please request higher limit here: https://forms.gle/ZfVduUGq2iSYcYGm8
Para resolver esse problema, preencha o formulário que aparece nas mensagens de erro ou entre em contato com o Cloud Customer Care.
Você não anexa o projeto de serviço ao projeto host.
Se você usar a VPC compartilhada e não anexar o projeto de serviço ao projeto host, vai receber a seguinte mensagem de erro:
Invalid network name <network-name>. Project <project-name> referenced is not the host project for <service-project-name>.
Para resolver esse problema, anexe o projeto de serviço ao projeto host.
Você cria uma instância em um projeto de serviço com o modo de conexão de peering direto e designa uma rede VPC compartilhada.
Se você criar uma instância do Memorystore para Redis em um projeto de serviço e designar uma rede VPC compartilhada do projeto host para a instância, não será possível usar o modo de conexão de peering direto.
Por padrão, o modo de conexão é definido como peering direto. Se você tentar
usar esse modo de conexão ao criar uma instância e também escolher uma
rede VPC compartilhada do projeto host como o valor do parâmetro
--network, vai receber a seguinte mensagem de erro:
Authorized_network must exist in the same project as redis instance
Para resolver o problema, siga um destes procedimentos:
- Ao criar a instância, use o modo de conexão de acesso a serviços particulares
(--connect-mode=private-service-access). - Escolha uma rede VPC autorizada que esteja no mesmo projeto da instância.
Você usa um intervalo de endereços IP para o Compute Engine que o Memorystore for Redis não pode acessar.
Não é possível acessar a instância do Memorystore para Redis de uma
VM do Compute Engine que tenha um endereço IP no intervalo 172.17.0.0/16.
Esse intervalo é reservado para um componente interno.
Para resolver esse problema, acesse a instância de uma VM do Compute Engine que tenha um endereço IP em um intervalo diferente.
Problemas ao se conectar à instância de outros recursos do Google Cloud
Nesta seção, explicamos os problemas que sua instância do Memorystore para Redis pode encontrar quando outros recursos tentam se conectar a ela.
Não é possível se conectar à instância em ambientes sem servidor que exigem um conector de acesso VPC sem servidor
Se não for possível se conectar à instância do Memorystore para Redis usando um dos ambientes sem servidor que exigem um conector de acesso VPC sem servidor, verifique se você configurou esse conector para seu ambiente. Para mais informações, consulte Requisito do conector de acesso VPC sem servidor.
Não é possível se conectar à instância em um cluster do Google Kubernetes Engine (GKE)
Para se conectar à instância do Memorystore for Redis por um cluster do GKE, é preciso ativar o alias de IP/VPC nativo no cluster.
É mais fácil ativar o alias de IP/nativo de VPC ao criar o cluster. Na seção de opções avançadas, selecione Nativo de VPC. Para mais informações, consulte Criar um cluster nativo de VPC.
Problemas do Identity and Access Management (IAM)
Nesta seção, explicamos os problemas do IAM que sua instância do Memorystore para Redis pode encontrar.
Você quer restaurar uma vinculação de política excluída para uma conta de serviço
O Memorystore para Redis usa as seguintes contas de serviço para gerenciar suas instâncias:
service-PROJECT_NUMBER@service-networking.service-PROJECT_NUMBER@cloud-redis.
Se você excluir as vinculações de política dessas contas de serviço, não será possível criar instâncias.
Se você tentar criar uma instância do Memorystore para Redis usando a Google Cloud CLI, talvez receba a seguinte mensagem de erro:
(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.
Para restabelecer a vinculação de política da conta de serviço service-networking,
execute o comando a seguir. Substitua VARIABLES pelos valores apropriados.
gcloud projects add-iam-policy-binding PROJECT_ID --member='serviceAccount:service-PROJECT_NUMBER@service-networking.' --role='roles/servicenetworking.serviceAgent'
Para restabelecer a vinculação de política da conta de serviço cloud-redis, execute
o comando a seguir. Substitua VARIABLES pelos valores apropriados.
gcloud projects add-iam-policy-binding PROJECT_ID --member='serviceAccount:service-PROJECT_NUMBER@cloud-redis.' --role='roles/redis.serviceAgent'
Problemas de tempo limite da operação
Os problemas a seguir resultam em uma instância do Redis que não responde e/ou em tempos limite de operação de instância/nó.
Problemas de partição de rede
Às vezes, Google Cloud os recursos não podem se comunicar entre zonas em uma região devido a um erro de partição de rede nos servidores do Google Cloud. Isso pode causar perda de conexão na instância, gerando um erro de tempo limite.
Depois que o Google Cloud resolver o erro de partição de rede para a região ou zona em que sua instância está provisionada, a conectividade será retomada normalmente.
Nesse problema, pode aparecer uma mensagem de erro de conectividade como esta:
telnet: Unable to connect to remote host: Connection timed out
Se não for possível identificar a causa do erro de tempo limite, entre em contato com o suporte doGoogle Cloud .
Projeto de serviço e projeto host que não estão no mesmo perímetro de controle de serviço da VPC
Se você estiver usando VPC compartilhada e um perímetro de controle de serviço VPC, e a operação de criação da instância do Redis atingir o tempo limite, isso poderá indicar que o projeto de serviço e o projeto host não estão no Mesmo perímetro de serviço. O projeto de serviço e o projeto host precisam estar no mesmo perímetro para que a instância do Redis se comunique com os clientes conectados pela rede VPC compartilhada.
Para ver se você está enfrentando esse problema, verifique os registros de auditoria da sua instância do Redis para o erro a seguir:
violationReason: "NETWORK_NOT_IN_SAME_SERVICE_PERIMETER"
Para resolver esse problema, coloque a rede do host e a rede de serviços no mesmo perímetro de serviço.
Como solucionar problemas de importação e exportação
Nesta seção, descrevemos alguns problemas comuns que podem ocorrer ao usar a importação e a exportação do Memorystore para Redis.
Os botões de importação e exportação estão desativados no console do Google Cloud
Problema: o usuário conectado ao console não tem
as permissões redis.instances.import e/ou redis.instances.export necessárias para
importar e/ou exportar arquivos RDB.
Solução: conceda as permissões ao usuário e atualize a página de detalhes da instância.
A operação de importação foi concluída, mas os dados não foram restaurados
Se uma operação de importação for concluída, mas os dados não forem restaurados, verifique primeiro o console do Google Cloud ou a linha de comando para ver se há uma mensagem de erro e resolva os problemas descritos na mensagem de erro.
Se houver uma falha durante o processo de importação, a instância será recuperada usando um arquivo RDB vazio. Tente restaurar os dados importando o mesmo arquivo RDB novamente ou usando um arquivo RDB diferente.
Ocorreu uma falha na importação porque o arquivo RDB era muito grande.
Se foi exibida a mensagem de erro "Tamanho do arquivo RDB de importação gs://bucket/object.rdb excede a memória máxima de 10 GB", escalone verticalmente sua instância e tente a importação novamente. Também é possível tentar importar um arquivo RDB menor para sua instância.
Solução de problemas da CLI do Google Cloud
Se você tiver um problema em que um comando da CLI gcloud não está disponível ou se o comando se comportar de maneira diferente da documentada, tente atualizar a CLI gcloud:
gcloud components update
Como interromper todos os comandos e conexões em andamento de uma instância do Redis
Como o Memorystore para Redis é um produto gerenciado pelo Google, há alguns
comandos que são
bloqueados na sua instância do Redis
para fornecer um ambiente seguro e confiável. Um dos comandos restritos é
CLIENT, que inclui CLIENT KILL, usado para interromper comandos.
Se um comando Redis estiver consumindo muita utilização da CPU/RAM e afetar seu ambiente de produção, reinicie a instância (para configurações de nível Basic) ou faça o failover para uma réplica (para configurações de nível Standard). Essa operação de reinicialização/failover interrompe todos os comandos em execução no servidor Redis e encerra todas as conexões em andamento.
Abaixo, você encontrará comandos para executar reinicializações ou failovers para cada configuração do Memorystore para Redis.
Como interromper comandos em instâncias do Memorystore para Redis de nível Standard
gcloud redis instances failover INSTANCE_NAME --data-protection-mode=limited-data-loss
Como interromper comandos em instâncias do Memorystore para Redis de nível básico
A única maneira de reiniciar uma instância do Memorystore para Redis é alterando a configuração dela, como escalonando verticalmente a instância. Veja abaixo um exemplo de comando que você pode executar para reiniciar a instância.
gcloud redis instances update INSTANCE_NAME --region REGION_ID --size NUMBER_GB
Depois de escalonar a instância para um tamanho diferente, execute outra operação de escalonamento para retorná-la ao tamanho original.
Problemas com a política da organização no compartilhamento restrito de domínio
Há um problema conhecido em que a política da organização iam.allowedPolicyMemberDomains causa erros quando usada com instâncias do Memorystore para Redis que usam o formato de conta de serviço PROJECT_NUMBER-compute@.
Dependendo de quando a instância foi criada, o Memorystore para Redis usa um dos dois formatos de conta de serviço. Para identificar o formato da conta de serviço da sua instância, consulte Formato da conta de serviço do Memorystore para Redis.
Quando esse problema ocorre, talvez você encontre a seguinte mensagem de erro: One or
more users named in the policy do not belong to a permitted customer.
Dependendo da política da sua organização e se você pode recriar a instância, é possível resolver esse erro usando uma das seguintes opções:
Recrie sua instância: as instâncias mais antigas usam o formato de conta de serviço
PROJECT_NUMBER-compute@, que as políticas de compartilhamento restrito de domínio costumam bloquear. As instâncias recém-criadas usam um formato de conta de serviço moderno que é compatível com a maioria das políticas da organização.Se a política da organização bloquear todos os domínios externos, essa opção não vai funcionar. Para ignorar a política, use a segunda opção.
Forçar o acesso à conta: se não for possível recriar a instância para receber o novo formato de conta de serviço ou se a política da organização bloquear o novo domínio da conta de serviço, será necessário ignorar a política forçando o acesso à conta para o projeto. Para mais informações, consulte Forçar o acesso à conta.