Todos os produtos
Search
Central de documentação

Tair (Redis® OSS-Compatible):Análise de chaves offline

Última atualização: Jun 26, 2026

Identificar chaves que consomem muita memória antes que causem problemas é difícil quando uma instância Redis está sob carga. A análise de chaves offline examina arquivos de backup da sua instância Tair (compatível com Redis OSS) para detectar chaves grandes e exibir o uso de memória, a distribuição de chaves e os tempos de expiração, sem impactar o desempenho da instância. Use os resultados para otimizar sua instância e evitar esgotamento de memória ou degradação de desempenho causada por desequilíbrio de chaves.

Este recurso baseia-se na funcionalidade de análise de cache do CloudDBA.

Limitações

  • Não há suporte para instâncias baseadas em disco.

  • Se você alterar o tipo da instância, não será possível analisar arquivos de backup criados antes da alteração.

  • Há suporte apenas para estruturas de dados do Redis Open-Source Edition e as seguintes estruturas proprietárias do Tair: TairString, TairHash, TairGIS, TairBloom, TairDoc, TairCpc e TairZset. A tarefa de análise falhará se o arquivo de backup contiver outras estruturas proprietárias do Tair.

Escolha um método de análise

Três métodos de análise estão disponíveis. Escolha com base na atualidade necessária dos dados.

Método

Atualidade dos dados

Recomendado quando

Use Recent Backup File

Último backup agendado

Inspeção diária ou de rotina

Select a historical backup file

Um ponto específico no passado

Comparação com um estado conhecido

Create New Backup for Analysis

Estado atual da instância

Investigação de um problema ativo

Ao analisar um arquivo de backup existente, confirme se o horário de criação corresponde ao momento que você deseja inspecionar.

Execute uma análise de chaves offline

Pré-requisitos

Antes de começar, certifique-se de ter:

  • Uma instância Tair (compatível com Redis OSS) que não seja baseada em disco

  • As permissões necessárias. Se estiver usando um usuário do Resource Access Management (RAM), consulte

Inicie uma tarefa de análise

  1. Faça login no console e acesse a página Instances. Selecione a região onde reside sua instância e clique em ID da instância.

  2. No painel de navegação à esquerda, escolha CloudDBA > Offline Key analysis. Por padrão, a página exibe os resultados da análise do dia anterior. Ajuste o intervalo de tempo conforme necessário.

  3. Clique em Analyze.

  4. Na caixa de diálogo, configure os seguintes parâmetros.

    Parâmetro

    Descrição

    Node

    O nó a ser analisado. Selecione toda a instância ou um nó específico.

    Analysis method

    O arquivo de backup a ser usado. Consulte Escolha um método de análise para obter orientações.

    Delimiter

    Caracteres usados para identificar prefixos de chave. Os delimitadores padrão são `:;,_-+@=

    #`. Deixe em branco para usar os padrões.

    Configure analysis node and method

  5. Clique em OK. O sistema envia a tarefa de análise e exibe seu status. Clique em Refresh para atualizar o status.

Visualize os resultados

Quando o status da tarefa indicar conclusão, clique em Details na coluna Actions.

A página de detalhes contém as seguintes seções:

  • Basic information — Atributos da instância e método de análise usado.

    Basic information

  • Relevant Nodes — Uso de memória e estatísticas de chaves para cada nó.

    Esta seção aparece apenas para instâncias cluster ou com divisão de leitura/escrita quando a instância inteira foi selecionada como Node .

    Relevant nodes

  • Details — Um detalhamento que inclui:

    • Uso e distribuição de memória por tipo de chave

    • Contagem de elementos e distribuição de tamanho dentro das chaves

    • Distribuição do tempo de expiração das chaves

    • Principais chaves grandes classificadas por memória

    Cache analysis details

Perguntas frequentes

Por que há tantas chaves expiradas?

Chaves com tempo de vida (TTL) configurado podem se acumular quando muitas expiram simultaneamente. A instância as limpa automaticamente, mas para liberar memória imediatamente, use o recurso Clear Data. Consulte Limpar chaves expiradas.

O que fazer se um erro "permission denied" for relatado ao usar um usuário RAM?

Conceda as permissões necessárias ao usuário RAM e tente novamente a operação. Para mais informações, consulte Cenários comuns e exemplos de políticas personalizadas.

Por que a velocidade de análise varia entre tarefas na mesma instância?

As tarefas de análise são executadas de forma assíncrona no CloudDBA. Se outras tarefas estiverem na fila antes da sua, a espera será maior. O tempo total depende da profundidade da fila, e não apenas do tamanho da sua instância.

Como corrigir decode rdbfile error: rdb: unknown object type 116 for key?

O backup contém estruturas Bloom não padronizadas, que não têm suporte para análise.

Como corrigir decode rdbfile error: rdb: invalid file format?

Duas causas comuns:

  • A configuração da instância foi alterada após a criação do backup. Selecione um backup que corresponda à configuração atual.

  • A Criptografia Transparente de Dados (TDE) está ativada. Este recurso não consegue analisar arquivos de backup criptografados.

Como corrigir decode rdbfile error: rdb: unknown module type?

O backup contém estruturas de dados proprietárias do Tair que não estão na lista de suportadas (TairString, TairHash, TairGIS, TairBloom, TairDoc, TairCpc, TairZset). A análise não pode prosseguir para backups que incluam estruturas sem suporte.

Como corrigir o erro XXX backup failed ao criar um novo backup para análise?

Um comando BGSAVE ou BGREWRITEAOF está em execução na instância, o que bloqueia o novo backup. Execute a análise fora do horário de pico ou mude para Use Recent Backup File ou Select a historical backup file.

Por que o uso de memória na página Details parece menor que o uso real?

A análise calcula a memória com base nos dados serializados de chaves e valores no arquivo de backup do Redis Database (RDB). Isso cobre apenas parte do consumo real de memória. O restante inclui:

  • Dados de estrutura, ponteiros e sobrecarga de alinhamento de bytes. Para instâncias com 250 milhões de chaves, isso pode adicionar aproximadamente 2–3 GB (alocados via jemalloc).

  • Buffers do lado do cliente: buffer de saída, buffer de consulta e buffer de reescrita de arquivo append-only (AOF).

  • Backlogs de replicação provenientes da replicação primário/réplica.

Por que o uso de memória para chaves Stream é várias vezes maior que o esperado?

Stream é uma estrutura de dados complexa que usa radix trees e listpacks internamente. A análise não consegue medir com precisão a memória dessas estruturas aninhadas, portanto os resultados são aproximados. Essa discrepância é estatística e não afeta a funcionalidade da instância.

Por que a contagem de elementos e o comprimento do elemento são iguais para chaves String?

Para instâncias Tair (compatíveis com Redis OSS), o número de elementos de uma chave String é definido como o comprimento do valor. Isso ocorre por design.

Referência de API

API

Descrição

CreateCacheAnalysisJob

Cria uma tarefa de análise de cache

DescribeCacheAnalysisJob

Consulta os detalhes de uma tarefa de análise de cache

DescribeCacheAnalysisJobs

Lista tarefas de análise de cache

Próximos passos