Todos os produtos
Search

Este produto

    Tair (Redis® OSS-Compatible):Estatísticas de top keys

    Central de documentação

    Tair (Redis® OSS-Compatible):Estatísticas de top keys

    Última atualização: Aug 25, 2026

    Quando o uso de memória ou CPU aumentar na sua instância Tair ou Redis, utilize o recurso Top Key Statistics para identificar rapidamente large keys e hot keys. Esse recurso exibe dados em tempo real e históricos sobre essas chaves — como chaves com muitos elementos, chaves que consomem muita memória e hot keys acessadas frequentemente — para ajudar a resolver problemas de desempenho.

    Mecanismo de identificação e classificação

    Para evitar sobrecarga no banco de dados, esse recurso coleta estatísticas apenas das chaves acessadas por operações de leitura ou escrita do cliente. Ele retém e exibe somente um número especificado de top keys por tipo, em vez de varrer todas as chaves do banco de dados em tempo real. Além disso, após a reinicialização da instância ou um failover de alta disponibilidade (HA), as estatísticas coletadas são limpas e o processo recomeça. Como resultado, chaves não acessadas por um longo período podem não aparecer nas estatísticas. Para analisar o uso e a distribuição de memória de todas as chaves do banco de dados, use o recurso Offline Key Analysis.

    Tipo de chave

    Versões aplicáveis

    Mecanismo estatístico

    Descrição

    Large key (por número de elementos)

    • Redis Open-Source Edition 5.0 ou posterior.

    • Tair (Enterprise Edition).

    Uma chave é considerada large key se seu número de elementos, como campos em um Hash ou membros em um Set, atingir ou ultrapassar um limiar (padrão: 2.000). Personalize esse limiar definindo o parâmetro bigkey-threshold.

    Nota

    • Instâncias de memória persistente não suportam o parâmetro bigkey-threshold.

    • Se esse parâmetro não aparecer nas configurações, atualize a versão secundária da sua instância e tente novamente.

    Exibe até as três principais large keys para cada tipo de dado. Se várias chaves tiverem o mesmo número de elementos, aquela gravada primeiro terá prioridade.

    Nota

    • Para instâncias de memória persistente do Tair (Enterprise Edition), apenas as três principais chaves por contagem de elementos em todos os tipos de chave são exibidas.

    • Para outras instâncias, se apenas três large keys forem exibidas no total, atualize a versão secundária e tente novamente.

    Large key (por uso de memória)

    Instâncias cloud-native otimizadas para memória do Tair (Enterprise Edition) com versão secundária 25.6.0.0 ou posterior.

    • Uma chave é considerada large key se seu uso total de memória exceder um limiar (padrão: 500 MB). Personalize esse limiar definindo o parâmetro bigkey-mem-threshold.

    • Uma chave também é classificada como large key se o uso médio de memória de seus elementos ultrapassar 1 MB. Para ajustar esse limiar, defina o parâmetro bigkey-field-mem-threshold. Por exemplo, uma chave String é considerada grande se seu valor exceder 1 MB. Uma chave Hash com 100 pares chave-valor é considerada grande se seu uso total de memória resultar em um tamanho médio de elemento superior a 1 MB.

    • A partir de 26 de maio de 2026, o valor padrão de bigkey-field-mem-threshold será alterado de 50 MB para 1 MB.

    Mostra até as três maiores large keys por tipo de dado. Quando houver empate no uso de memória, a chave gravada primeiro recebe prioridade.

    Hot key (por QPS)

    • Redis Open-Source Edition 5.0 ou posterior.

    • Tair (Enterprise Edition).

    Uma chave é classificada como hot key quando suas consultas por segundo (QPS) ultrapassam 5.000. Personalize esse limiar definindo o parâmetro hotkey-threshold.

    O sistema exibe até as 50 principais hot keys e mostra seu QPS preciso em tempo real.

    As estatísticas de hot keys têm suporte limitado em versões secundárias anteriores. Recomendamos atualizar para a versão secundária mais recente.

    Em versões anteriores ao Redis Open-Source Edition 7.0.18, 6.0.2.9 e 5.5.2.9, ou ao Tair otimizado para memória 5.0.50 e 25.2.0.0, o limiar de QPS para hot keys era fixo em 3.000 e não podia ser ajustado. Apenas uma faixa aproximada de QPS podia ser exibida, e o Redis Open-Source Edition suportava estatísticas para apenas 20 hot keys.

    Hot key (por tráfego)

    Instâncias cloud-native otimizadas para memória do Tair (Enterprise Edition) com versão secundária 25.2.0.0 ou posterior.

    Uma chave é identificada como hot key se seu tráfego de acesso exceder 1 MB/s.

    • Esse recurso vem desativado por padrão. Para ativá-lo, defina o parâmetro #no_loose_high-cost-key-enabled como yes.

    • Ajuste o limiar de tráfego em B/s definindo o parâmetro #no_loose_high-cost-key-traffic-bytes-threshold.

    • Utilize os parâmetros #no_loose_high-cost-key-parse-hashtag e #no_loose_high-cost-key-parse-prefix para ativar estatísticas para hashtags e prefixos. Isso permite que o sistema identifique casos em que chaves individuais têm baixo tráfego, mas o tráfego agregado de chaves com a mesma hashtag ou prefixo excede o limiar. Esse recurso requer atualização para a versão secundária 25.9.1.0 ou posterior.

    O sistema apresenta até as 50 principais hot keys, mostrando seu tráfego de entrada e saída preciso, além da frequência de acesso.

    Nota

    Há suporte para estatísticas de chaves inexistentes. Se o tipo de dado for exibido como not-exist-key, isso indica que a chave não existe, mas é acessada frequentemente.

    Este recurso oferece suporte às seguintes estruturas de dados:

    • Estruturas de dados nativas do Redis: String, List, Hash, Set, Zset e Stream

    • Estruturas de dados desenvolvidas pelo Tair: TairString, TairHash, TairGIS, TairBloom, TairDoc, TairCpc, TairZset, TairRoaring, TairTS e TairSearch

      Nota

      As instâncias de memória persistente do Tair (Enterprise Edition) suportam estatísticas apenas para TairHash e TairString.

    Procedimento

    1. Faça login no console e acesse a página Instances. Na barra de navegação superior, selecione a região onde reside a instância que você deseja gerenciar. Em seguida, localize a instância e clique em ID da instância.

    2. No painel de navegação à esquerda, escolha CloudDBA > Top Key Statistics.

    3. Nesta página, visualize dados em tempo real e históricos.

      A página Top Key Statistics contém quatro seções: Real-time Large Keys, Historical Large Keys, Real-time Hot Keys e Historical Hot Keys. Defina os limiares para identificação de large keys e hot keys, clique em Refresh para buscar manualmente os dados mais recentes ou ative a opção Auto-refresh para atualizar os resultados automaticamente.

      Nota

      • Se sua instância usar uma arquitetura cluster ou de divisão de leitura/escrita, também é possível selecionar um nó específico na lista suspensa Current Node para visualizar seus dados.

      • Consulte dados históricos dos últimos quatro dias. O intervalo máximo de tempo para uma única consulta é de três horas.

    Referência de API

    DAS API

    Descrição

    DescribeHotBigKeys

    Obtém hot keys em tempo real e large keys que estão atualmente na memória.

    DescribeTopHotKeys

    Recupera as 20 principais hot keys durante um período especificado.

    DescribeTopBigKeys

    Recupera as 20 principais large keys durante um período especificado.

    DescribeHotKeys

    Obtém as hot keys de uma instância Redis.

    Perguntas frequentes

    • P: Por que chaves do tipo String aparecem em Large key (by number of elements)?

      R: No Redis Open-Source Edition e em algumas versões anteriores do Tair, chaves do tipo String são exibidas se o comprimento do valor exceder o limiar, cujo padrão é 2.000.

    • Por que uma chave com menos de 10 elementos aparece como large key?

      A causa mais provável é que o próprio nome da chave seja grande. Execute memory usage key_name para verificar seu consumo real de memória. Se o resultado for inesperadamente alto, considere renomear ou reestruturar a chave.

      Uma causa menos comum é uma versão secundária desatualizada. Instâncias com versão secundária anterior a 5.2.7 possuem um bigkey-threshold padrão de 0, o que faz com que chaves com baixo uso de memória apareçam como large keys. Atualize a versão secundária para resolver isso.