Redis: visualizar chaves, status e edição

O que faz

O que é aceito

• Connection string redis:// ou rediss:// (TLS), ou host, porta (1 a 65535), usuário, senha, TLS e banco.
• Banco de 0 a 1023.
• Gravar string numa chave string ou nova. O TTL que a chave tinha é mantido (lido com PTTL e regravado com PX, em qualquer versão do Redis), ou você define um TTL novo na mesma edição.
• Gravar campo numa chave hash ou nova.
• TTL em segundos, inteiro e positivo, até 10 anos, ou remover o TTL.
• Renomear para um nome que ainda não existe (RENAMENX).
• Apagar uma chave, ou várias de uma vez: até 20 chaves por minuto por cliente.

O que não é aceito

• Gravar string numa chave de outro tipo, ou campo de hash numa chave que não é hash: é recusado em vez de sobrescrever.
• Renomear para um nome que já existe.
• FLUSHALL, FLUSHDB, KEYS, console de comandos e os demais comandos recusados da tabela abaixo.
• Redis em modo cluster.
• Navegar ou editar no Free; editar ou apagar como membro (na web; no desktop, a partir da 2.7.0).

Limites e tempos

Confirmações

• Apagar uma chave ou um campo de hash pede confirmação.
• Apagar mais de uma chave pede que você digite a quantidade de chaves.

Auditoria

• Web: cada gravação, mudança de TTL, renomeação e remoção vai para a auditoria da organização, no banco: quem, quando, cliente, banco, nome da chave (e do campo) e o tamanho do valor em bytes, nunca o valor. Numa remoção múltipla, ficam a quantidade e os primeiros 50 nomes.
• Desktop: as mesmas ações vão para o arquivo kubepier-audit.log, na pasta de dados do app, com os nomes das chaves e o resultado.

Comandos do Redis

Web e desktop usam a mesma lista de comandos permitidos, conferida antes de cada comando sair. Qualquer comando fora dela é recusado. Não existe console de comandos livre.

Os comandos de escrita só passam no modo escrita: na web, nas rotas de admin do plano pago; no desktop, nos planos Pro e Team (a partir da 2.7.0, só para admin). Um comando recusado volta como "comando não permitido" (403 na web) e não chega ao Redis.

Na conexão, o cliente Redis também envia AUTH (senha ou usuário ACL).

Permissões necessárias do seu lado

Com ACL (Redis 6 ou mais novo), crie um usuário só para o Kubepier com estes comandos. Em Redis sem ACL, vale a senha (AUTH).

# Só leitura (status, navegador de chaves, INFO, SLOWLOG)
ACL SETUSER kubepier on >SENHA ~* -@all +ping +info +dbsize +select \
  +scan +type +ttl +pttl +memory|usage +memory|stats +strlen +get +getrange \
  +hlen +hscan +llen +lrange +scard +sscan +zcard +zrange +xlen +xrange +slowlog|get

# Edição (Pro/Team; admin): acrescente
ACL SETUSER kubepier +set +hset +hdel +expire +persist +renamenx +unlink

Sem MEMORY USAGE (desligado em alguns serviços gerenciados), a memória por chave aparece vazia. No Azure Cache for Redis, a chave de acesso funciona como senha.

Azure Cache for Redis (porta 6380, TLS) e rota de conexão

No cadastro do Redis, escolha a Rota de conexão. Direta: libere os IPs de saída no firewall (Azure Cache: Firewall; porta 6380 com TLS). Pelo cluster: para caches com private endpoint, ElastiCache ou Memorystore, por um relay num cluster na mesma rede. Na rota Direta, um host que resolve só para IP privado responde host_privado na hora, sem tentar conectar. Conexão encerrada pelo servidor (conexao_encerrada) em geral é firewall sem os IPs de saída, TLS ou porta errados, ou limite de conexões: libere os IPs ou troque para Pelo cluster. Senha errada não é conexão encerrada: desde 05/10/2026 na web, e a partir da 2.3.0 no desktop, ela aparece como erro de autenticação (WRONGPASS).

• Conectar serviços: redes públicas e privadas

Erros comuns

• WRONGPASS (invalid username-password pair) ou NOAUTH: erro de autenticação: a senha (ou o usuário ACL) salva está errada, ou falta a senha. Não é rede: corrija a credencial no cadastro do cliente. No Azure Cache, cole a connection string inteira copiada em Chaves de acesso do cache certo, e não só a chave, para não misturar a chave de dev com o host de prd. Na web, o status mostra a mensagem do Redis e as ações respondem "sem permissão no serviço". No desktop até a 2.2.0, esse caso aparece como Connection is closed.
• "sem permissão no serviço" / NOPERM: falta um comando do ACL acima.
• "A chave é do tipo …": a chave existe com outro tipo; o Kubepier não sobrescreve.
• "Já existe uma chave com esse nome": escolha outro nome.
• "muitas remoções" (429 na web): são 20 chaves apagadas por minuto por cliente.
• "comando não permitido": o comando está fora da lista; não há como liberar outros.
• Erro de conexão ou TLS: confira host, porta e TLS (Azure Cache: 6380 com TLS) e, na web, os IPs de saída.

• Rede e IPs de saída
• Conectar serviços: redes públicas e privadas
• Referência rápida: todos os limites