Ferramentas Redis
Ferramentas do Redis: visualização de chaves e streams, IntelliSense, Cluster e Sentinel, profiler, Pub/Sub, análise de memória, ações em massa, usuários ACL e formatos de valor.
O Redis possui seu próprio conjunto de ferramentas ao lado do navegador de chaves. Duas monitoram o servidor em tempo real em uma conexão dedicada, e o resto responde às perguntas de administração que os usuários do Redis mais fazem: para onde foi a memória, como limpar milhares de chaves, o que um valor binário realmente contém e se o log lento está registrando algo.
Eles funcionam no Redis e nos servidores que utilizam seu protocolo - Valkey, KeyDB, DragonflyDB, Amazon ElastiCache e Amazon MemoryDB, e no Redis Cluster (incluindo o modo cluster do ElastiCache e o MemoryDB), onde os comandos são direcionados para o nó que possui o slot de cada chave, veja Redis Cluster.
Diagnóstico de conexão
Testar conexão em uma conexão Redis percorre a conexão passo a passo e escreve cada passo no log de diagnóstico conforme é concluído, assim você pode ver exatamente até onde chegou. Abra o log com ⌘⇧L (Ctrl+Shift+L); defina Preferências › Avançado › Nível de log para Detalhado para ver cada passo, um passo que falhar também é registrado apenas em Erros. Quando um passo falha, o erro no editor de conexão começa com esse passo - Falha no TLS: …, Falha em AUTH: … - em vez de um «não foi possível conectar» genérico.
| Passo | O que ele diz |
|---|---|
| Banco de dados | Nova consulta, Filtrar chaves…, Limpar filtro de chaves, Escanear mais; um Edição em massa submenu com Excluir Chaves por Padrão… e Definir TTL por Padrão…; Importar / Exportar com Importar Arquivo de Comando… e Exportar como Arquivo de Comando…; Ferramentas com Analisador de Memória…, Topologia de Cluster… (em um cluster), Profiler…, Pub/Sub…, Painel do Servidor, Monitor de Atividade, Insights de Consulta, Uso de Disco, Histórico de Consultas e Segurança (a página ACL); então Copiar Nome, Renomear… e Mostrar Apenas Bancos de Dados… para nomear e selecionar os bancos de dados que você vê, e Atualizar. |
| Pasta de chaves | Copiar comando SCAN, Escanear mais, Excluir chaves na pasta…, Definir TTL na pasta…, Exportar pasta como arquivo de comandos…. |
| Chave | Abrir valor (a visualização de chave), Abrir na aba de consulta; Renomear…, um Expiração submenu com Definir TTL… e Remover expiração (PERSIST), e Copiar para com Copiar para o Banco de Dados… e Copiar para a Conexão…; Copiar com Copiar Nome e Copiar Comando; Excluir Chave…. |
| Índice de pesquisa | Abrir (FT.INFO), Consultar…, Explicar…, Perfil…, Excluir índice…. |
| Nota de fila | Carregar mais, Escanear mais. |
Como as conexões do SQLly se comportam
- RESP3 quando o servidor o possui. O SQLly solicita o protocolo RESP3 e permanece silenciosamente no RESP2 quando o servidor não o oferece. Os resultados parecem os mesmos de qualquer forma.
SQLLY.SERVERINFOrelata qual delas a conexão está usando. - Cada conexão tem um nome. As abas de consulta, o Profiler e o visualizador Pub/Sub nomeiam suas conexões
sqlly:<connection name>:<process id>, entãoCLIENT LISTe a aba Sessões do Monitor de Atividade mostra quais são do SQLly - incluindo as do próprio ProfilerMONITORconexão. Um servidor ou ACL que recusaCLIENT SETNAMEsimplesmente os deixa sem nome. (Em um servidor sem RESP3, a conexão do visualizador Pub/Sub não pode ser nomeada.) - Um tempo limite de comando. Um comando que não recebe resposta dentro do Tempo limite da consulta - 30 segundos quando estiver em branco, sem limite quando for 0 - falha com uma mensagem que cita o comando e o limite. Os comandos de bloqueio ganham, por cima, a espera que você pediu, então
BLPOP jobs 20nunca é interrompido antes da hora. O comando pode até terminar no servidor, então o SQLly nunca o executa de novo para você. O Profiler e o visualizador Pub/Sub esperam sem limite. - Túneis SSH permanecem ativos. Um túnel envia um keepalive SSH a cada 30 segundos de inatividade (defina Keepalive (segundos) nas configurações do túnel; 0 desativa), assim túneis ociosos sobrevivem a firewalls e tempos limite de NAT. Se a sessão SSH cair de qualquer forma, a próxima execução abre um novo túnel e suas Mensagens dizem Túnel restabelecido. Nada é reexecutado no seu lugar, confira se o comando que estava rodando quando o túnel caiu fez efeito antes de rodá-lo de novo.
O explorador de chaves
O Redis não tem catálogo, então sua parte do explorador é construída a partir das próprias chaves. Expanda um servidor Redis e você verá seus bancos de dados lógicos - db0,
db1, e assim por diante, cada um com a contagem de chaves. Expanda um banco de dados e o SQLly lista as chaves dele com uma única SCAN (nunca KEYS *), organizando-as em pastas pelos delimitadores de chave da conexão: user:42:profile caem em usuário › 42. O delimitador é : a menos que você defina outros no campo Delimitadores de chave campo. Digite vários caracteres para dividir em cada um deles - :| dobra ambos user:42 e
cache|en|home - ou separe delimitadores mais longos com espaços (:: |); um único caractere, ou um repetido como ::, continua significando exatamente isso. Cada chave mostra o próprio tipo e, quando tem, o tempo de vida.
Uma listagem pode ser cortada de duas formas, e uma única linha de nota no rodapé cobre as duas. A varredura para em 10.000 chaves, e a árvore mostra as primeiras 2.000 linhas do que foi percorrido. A nota diz o que está sendo exibido do que foi percorrido e se a própria varredura parou, por exemplo Mostrando 2.000 de 7.350 linhas de 10.000 chaves varridas; o SCAN parou ali. Clique na nota para carregar mais linhas (sem novo escaneamento, elas já foram percorridas), ou escolha Varrer mais na anotação, no banco de dados ou em uma pasta para continuar a mesma SCAN de onde parou; as novas chaves se juntam às linhas já exibidas e a contagem das pastas é atualizada. Use
Filtrar chaves… para restringir a listagem a um padrão e
Limpar filtro de chave para voltar. O filtro é lembrado por banco de dados na conexão, então volta a valer na próxima vez que você abrir o aplicativo, e o diálogo Filtrar chaves… oferece os últimos cinco padrões que você digitou nessa conexão em um
Recente menu suspenso. As pastas revarrem o próprio prefixo quando você as expande, então árvores profundas carregam um nível por vez.
Filtrar chaves corresponde a chaves nomes com um glob, como user:*; ele nunca olha dentro dos valores. Se você digitar algo que se pareça com uma consulta de valor - JSON como
{"name": "bob"} ou uma consulta de busca, como @name:bob - o diálogo avisa em vez de simplesmente não listar nada, e oferece Pesquise valores com FT.SEARCH…. Em um servidor com o módulo de busca e um índice, isso abre uma aba de consulta com um FT.SEARCH sobre o primeiro índice (os outros são nomeados em um comentário), transformando campos JSON em @field:"value" cláusulas para você revisar e executar; sem um índice ou o módulo, o diálogo explica o que é necessário. Hash tags de cluster como {user1}:* são padrões comuns e nunca acionam a dica.
Listagens de chaves em uma aba de consulta
Quando você quiser ordenar ou filtrar chaves em vez de apenas navegá-las, execute
SQLLY.KEYS <pattern> <limit> em uma aba de consulta, por exemplo
SQLLY.KEYS session:* 5000. Ele percorre o keyspace com o mesmo limite de
SCAN que o explorador e retorna uma grade normal com key,
type e ttl_seconds colunas, então você pode clicar no cabeçalho
ttl_seconds cabeçalho para ordenar por tempo de vida ou usar Filtrar Linhas… para manter, por exemplo, chaves sem expiração ou com menos de uma hora restante.
Depois aja sobre o que você encontrou: selecione linhas (ou toda a coluna key coluna), clique com o botão direito e abra Ferramentas › Chaves Redis para Excluir chaves selecionadas…, Definir TTL nas chaves selecionadas… ou
Remover expiração das chaves selecionadas…. O diálogo lista as chaves selecionadas primeiro, a exclusão pede que você digite a quantidade de chaves de volta, e nada é gravado em uma conexão somente leitura ou de produção bloqueada, os mesmos controles que o
ações em massa. O mesmo menu aparece no formato do relatório de top keys do Memory Analyzer (SQLLY.TOPKEYS) e em
SQLLY.KEYINFO; resultados cuja coluna key coluna não é um nome de chave, como INFO, nunca oferecem isso. As chaves atuam na conexão e no banco de dados com os quais a aba interage.
Cada linha de banco de dados mostra sua contagem de chaves e, quando qualquer chave tem expiração, quantas - 120 chaves · com expiração: 7 - direto das estatísticas de keyspace do servidor. Abrir uma lista, um set ordenado ou um stream lê os primeiros 1.000 elementos, e a aba é nomeada assim (orders — primeiros 1.000) para que um valor longo nunca seja confundido com o conteúdo inteiro.


O que os menus de clique direito oferecem
| Em um… | Você pode |
|---|---|
| Banco de dados | Nova consulta, Filtrar chaves…, Limpar filtro de chaves, Escanear mais; Edição em massa (Excluir Chaves por Padrão…, Definir TTL por Padrão…); Importar / Exportar (Importar Arquivo de Comando…, Exportar como Arquivo de Comando…); e Ferramentas com Analisador de Memória…, Profiler…, Pub/Sub…, Painel do Servidor, Monitor de Atividade, Insights de Consulta, Uso de Disco e Histórico de Consultas. |
| Pasta de chaves | Copiar comando SCAN, Escanear mais, Excluir chaves na pasta…, Definir TTL na pasta…. |
| Chave | Abrir valor, Abrir na aba de consulta; Renomear…, Expiração (Definir TTL…, Remover expiração (PERSIST)), Copiar para; Copiar (Copiar Nome, Copiar Comando); Excluir Chave…. |
| Nota de fila | Carregar mais, Escanear mais. |
As entradas de escrita - exclusões, alterações de TTL, renomeações, cópias e importações - estão acinzentadas em uma conexão configurada para Bloquear tudo menos SELECT, e uma conexão de produção bloqueada pede que você desbloqueie a escrita primeiro.
Em uma aba de consulta, uma conexão Redis executa um comando por linha. IntelliSense de comandos completa comandos, opções, subcomandos e nomes de chaves; a validação SQL e o formatador não se aplicam.
Ler e alterar chaves
Abrir uma chave em visualização da chave para percorrer seu valor e editá-lo com o comando mostrado primeiro; uma chave de stream adiciona abas para seus grupos de consumidores e entradas pendentes. Em uma aba de consulta, IntelliSense de comando completa comandos, opções e nomes de chaves, e as respostas do Redis Stack retornam como tabelas.
- Visualização de chaves
- Abra uma chave como uma visualização: faixa de cabeçalho, valor paginado e edições por tipo que mostram o comando exato antes de serem executadas.
- Streams e grupos de consumidores
- Navegue por um stream, veja grupos, consumidores, entradas pendentes e atraso, e execute comandos de stream revisados a partir da visualização da chave.
- IntelliSense de comandos
- Autocompleta comandos, opções, subcomandos e nomes de chaves detectados, com sintaxe e selos de segurança ao passar o mouse.
- Módulos do Redis Stack
- JSON, Search, TimeSeries e os tipos probabilísticos como grades reais, além do navegador de índices de busca no explorador.
Conecte-se a clusters e Sentinel
Uma conexão pode rotear comandos através de um Redis Cluster, incluindo o modo cluster do ElastiCache e MemoryDB, ou encontrar o mestre atual através de Sentinel e seguir failovers.
- Redis Cluster
- Redis Cluster, modo cluster do ElastiCache e MemoryDB: roteamento de slots, um mapa de nós para endereços de nós inacessíveis, encaminhamentos SSH por nó e topologia.
- Sentinel
- Conecte-se pelo Redis Sentinel usando o nome do mestre, leia de réplicas e sobreviva a failovers.
Assista ao vivo
Recorra a estes quando precisar ver o tráfego enquanto ele acontece: o Profiler para descobrir qual cliente está sobrecarregando uma chave, o Visualizador Pub/Sub para verificar se as mensagens estão sendo publicadas onde você espera. Ambos são abas no Monitor de Atividade e executam apenas no aplicativo de desktop.
- Profiler
- Uma captura do MONITOR limitada e com tempo limitado, em uma conexão própria, com pausa, filtros e uma parada obrigatória.
- Visualizador Pub/Sub
- Inscreva-se em canais, padrões ou em cada evento de chave de um banco de dados e veja as mensagens chegarem ao vivo.
Cuide dele
Comece com Ferramentas › Uso de Disco para memória por banco de dados, depois o analisador de memória para ver quais tipos e chaves são responsáveis por ela. Ações em massa limpe o que você encontrar, formatos de valor decodifica o que uma chave realmente contém, e o log lento página cobre o limite que decide quais comandos são registrados.
- Analisador de memória
- Memória por tipo de dado, as maiores chaves e um histograma de TTL a partir de uma amostra limitada.
- Ações em massa
- Exclua ou expire chaves por padrão, primeiro com uma contagem de teste, e importe arquivos de comandos.
- Usuários ACL
- Veja todos os usuários ACL e as negações de acesso recentes, e gere scripts das alterações ACL SETUSER / ACL DELUSER revisadas.
- Formatos de valor
- Visualize um valor como UTF-8, JSON, hexadecimal, MessagePack, Base64, Protobuf, ou gzip, zstd e LZ4 descomprimidos, com a sua escolha lembrada por chave.
- Limite do slow log
- Veja o limite do slow-log e altere-o através de um CONFIG SET revisado.
As ferramentas ao vivo abrem a própria conexão e sempre têm um limite e um botão de parar, então deixar uma aberta não estoura a memória nem prende a conexão que suas consultas usam. A amostra do analisador de memória e a contagem de simulação das ações em massa têm um Parar também: uma amostra parada mantém os relatórios anteriores na tela, e uma contagem parada é rotulada como parcial.