Todos os produtos
Search

Este produto

    Tair (Redis® OSS-Compatible):DescribeHistoryMonitorValues

    Central de documentação

    Tair (Redis® OSS-Compatible):DescribeHistoryMonitorValues

    Última atualização: Jun 29, 2026

    Consulta as informações de monitoramento de desempenho de uma instância Tair (compatível com Redis® OSS).

    Descrição da operação

    Para a operação correspondente no console desta API, consulte Monitoramento de desempenho.

    Experimente agora

    Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

    Testar

    Autorização RAM

    A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

    • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

    • API: A API que você pode chamar para executar a ação.

    • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

    • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

      • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

      • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

    • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

    • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

    Ação

    Nível de acesso

    Tipo de recurso

    Chave de condição

    Ação dependente

    kvstore:DescribeHistoryMonitorValues

    get

    *DBInstance

    acs:kvstore:{#regionId}:{#accountId}:instance/{#instanceId}
    • kvstore:ResourceTag
    • kvstore:ResourceTag
    • kvstore:ResourceTag
    • kvstore:ResourceTag
    		 Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    InstanceId

    string

    Sim

    O ID da instância.

    r-bp1zxszhcgatnx******
    StartTime

    string

    Sim

    A hora de início da consulta para dados históricos de monitoramento. Especifique a hora no formato aaaa-MM-ddTHH:mm:ssZ (UTC).

    2022-11-06T00:00:00Z
    EndTime

    string

    Sim

    A hora de término da consulta para dados históricos de monitoramento. A hora de término deve ser posterior à hora de início. Especifique a hora no formato aaaa-MM-ddTHH:mm:ssZ (UTC).

    Nota

    Você pode consultar dados de monitoramento do último mês, e o intervalo máximo de consulta não pode exceder 7 dias.

    2022-11-06T00:30:00Z
    IntervalForHistory

    string

    Sim

    Este parâmetro foi descontinuado. O valor é fixo em 01m.

    O sistema determina automaticamente o intervalo de consulta com base na hora de início e na hora de término. Por exemplo, se o intervalo de tempo da consulta for menor ou igual a 10 minutos, a frequência de agregação de dados será de 5s, e os resultados da consulta serão retornados com uma frequência de 5s.

    Nota

    • Os resultados da consulta são alinhados com a frequência de agregação de dados da instância. Se a StartTime especificada não coincidir com um ponto de agregação de dados, o primeiro ponto de tempo retornado pelo sistema será o ponto de agregação de dados mais próximo. Por exemplo, se a StartTime especificada for 2022-01-20T12:01:48Z, o primeiro ponto de tempo retornado pelo sistema será 2022-01-20T12:01:45Z.

    • Se o número de shards de dados da instância for maior ou igual a 32, a frequência mínima de agregação de dados será de 1 minuto.

    01m
    MonitorKeys

    string

    Não

    As métricas de monitoramento. Separe várias métricas de monitoramento com vírgulas (,). Usando CpuUsage como exemplo:

    • Arquitetura de cluster ou de divisão de leitura e gravação:

      • Para consultar o uso geral de CPU de todos os nós de dados (DB), especifique CpuUsage$db.

      • Para consultar o uso de CPU de um único nó de dados, especifique CpuUsage e defina o parâmetro NodeId como o nó DB.

    • Arquitetura padrão (primário/secundário): Especifique CpuUsage.

    Para obter mais informações sobre as métricas de monitoramento e descrições detalhadas, consulte Descrição do parâmetro MonitorKeys.

    Nota

    • Valor padrão: vazio. As métricas UsedMemory e quotaMemory são retornadas.

    • Para garantir a eficiência da consulta, especifique no máximo 5 métricas de monitoramento em uma única solicitação ao consultar um único nó. Especifique no máximo 1 métrica de monitoramento em uma única solicitação ao consultar métricas de monitoramento agregadas.

    CpuUsage
    NodeId

    string

    Não

    O ID do nó na instância. Especifique este parâmetro para consultar as informações de monitoramento de um nó específico.

    Nota

    • Este parâmetro está disponível apenas quando a instância usa uma arquitetura de divisão de leitura e gravação ou de cluster.

    • Chame a operação DescribeLogicInstanceTopology para consultar o ID do nó.

    r-bp1zxszhcgatnx****-db-0#1679****
    NodeRole

    string

    Não

    Para consultar as métricas de um nó somente leitura em uma instância de arquitetura de divisão de leitura e gravação nativa da nuvem, especifique o NodeId e defina este parâmetro como READONLY.

    Nota

    Em outros casos, não especifique este parâmetro (ou defina-o como MASTER).

    READONLY
    Type

    string

    Não

    Descrição do parâmetro MonitorKeys

    Ao chamar a API, especifique os parâmetros na coluna MonitorKeys na tabela a seguir. O sistema retorna as submétricas. As instâncias suportam métricas gerais e métricas de estatísticas de comandos.

    Métricas gerais

    A seguir, descreve-se como usar as métricas gerais, usando CpuUsage como exemplo.

    • Arquitetura de cluster ou de divisão de leitura e gravação:

      • Para consultar o uso geral de CPU de todos os nós de dados (DB): Especifique CpuUsage$db.

      • Para consultar o uso geral de CPU de todos os nós Proxy: Especifique CpuUsage$proxy.

      • Para consultar o uso de CPU de um único nó de dados ou nó Proxy: Especifique CpuUsage e defina o parâmetro NodeId como o nó DB ou nó Proxy.

    • Arquitetura padrão (primário/secundário): Especifique CpuUsage.

    MonitorKeysSubmétricaUnidadeDescriçãoEscopo
    CpuUsageCpuUsage%Uso de CPU. Intervalo de valores: 0 a 100.
    > Se sua instância usou ou retornou anteriormente o parâmetro RedisCpuUsage, você ainda pode usar o parâmetro original.    		- DB
    - Agregação de DB
    - Proxy
    - Agregação de Proxy
    MemoryUsagememoryUsage%Uso de memória.- DB
    - Agregação de DB
    quotaMemoryquotaMemoryBytesA memória total do shard atual.- DB
    - Agregação de DB
    UsedMemoryUsedMemoryBytesA memória usada, incluindo dados e cache.- DB
    - Agregação de DB
    Tair_PmemUsagePmemUsage%O uso de memória persistente, a memória persistente usada e a memória persistente total, respectivamente.
    Apenas instâncias otimizadas para memória persistente suportam esta métrica.    		- DB
    - Agregação de DB
    Tair_PmemPmemUsedBytes
    PmemQuotaBytes
    Redis_DetailedSpaceUsageins_sizeMBO espaço total de armazenamento da instância, o espaço em disco usado por arquivos de dados (incluindo arquivos AOF e RDB) e o espaço em disco usado por arquivos de log (incluindo logs de operação), respectivamente.
    Apenas instâncias otimizadas para memória no modo de implantação clássico (anteriormente disco local) suportam esta métrica.    		- DB
    - Agregação de DB
    data_sizeMB
    log_sizeMB
    Redis_Memory_Monitorused_memory_rssBytesA memória física ocupada pelo processo, que é a memória alocada pelo sistema operacional para o serviço Tair.- DB
    used_memory_luaBytesA memória usada por scripts Lua.
    used_memory_startupBytesA memória consumida quando o Tair é iniciado.
    lazyfree_pending_objectsContagensO número de chaves pendentes de recuperação real de memória durante as operações de lazy free do Tair.
    used_memory_overheadBytesA sobrecarga de memória usada pelo Tair para manter mecanismos internos para o conjunto de dados, incluindo buffers de saída de todos os clientes, buffers de consulta e AOF.
    used_memory_datasetBytesO espaço de memória ocupado pelos dados.
    CustomerMemoryUsageCustomerMemoryUsage%Uso de memória do usuário. Intervalo de valores: 0 a 100.- DB
    - Agregação de DB
    UsedQPSTotalQpsContagens/sO número total de solicitações por segundo, incluindo comandos de leitura e gravação.- DB
    - Agregação de DB
    - Proxy
    - Agregação de Proxy
    GetQpsContagens/sO número de solicitações de comandos de leitura e gravação por segundo, respectivamente. A versão compatível da instância deve ser Redis 4.0 ou posterior.
    PutQpsContagens/s
    OtherOpsContagens/sSolicitações sem atributos de leitura ou gravação, como PING, INFO, SELECT e AUTH. Como o Proxy realiza um processamento especial nas solicitações, se a instância tiver nós Proxy, OtherOps inclui apenas algumas solicitações INFO.
    ConnectionUsageconnectionUsage%Uso de conexões. Método de cálculo: número de conexões usadas ÷ total de conexões suportadas pela instância. Esta métrica é útil quando os clientes se conectam a uma instância (arquitetura de cluster) por meio de um endereço de conexão direta.- DB
    - Agregação de DB
    UsedConnectionConnCountContagensO número de conexões usadas.
    IntranetInInFlowKB/sAs taxas de tráfego de entrada e saída.- DB
    - Agregação de DB
    - Proxy
    - Agregação de Proxy
    IntranetOutOutFlowKB/s
    IntranetInRatiointranetInRatio%O uso de tráfego de entrada e saída.- DB
    - Agregação de DB
    IntranetOutRatiointranetOutRatio%
    Redis_Avg_Rt_MonitorAvgRtusA latência média, que é o tempo médio desde quando o nó de backend recebe um comando até quando envia uma resposta.
    - A métrica para nós DB não inclui o tempo consumido pelo Proxy e pelo balanceamento de carga.
    - A métrica para nós Proxy inclui o tempo consumido pelo DB e pelo Proxy, mas não inclui o tempo consumido pelo balanceamento de carga.    		- DB
    - Agregação de DB
    - Proxy
    - Agregação de Proxy
    Redis_Max_Rt_Monitor

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    MonitorHistory

    string

    As informações de monitoramento retornadas no formato JSON. Para obter mais informações, consulte Descrição dos parâmetros de monitoramento.

    Nota

    Para melhorar a eficiência da transmissão de dados, apenas os dados de monitoramento diferentes de 0 são retornados; os demais dados de monitoramento não exibidos têm o valor padrão 0.

    "{\"2022-11-06T00:00:00Z\":{\"memoryUsage\":\"6.67\"},\"2022-11-06T00:00:05Z\":{\"memoryUsage\":\"6.67\"},\"2022-11-06T00:00:10Z\":{\"memoryUsage\":\"6.67\"},\"2022-11-06T00:00:15Z\":{\"memoryUsage\":\"6.67\"},\"2022-11-06T00:00:20Z\":{\"memoryUsage\":\"6.67\"},\"2022-11-06T00:00:25Z\":{\"memoryUsage\":\"6.67\"}}"
    RequestId

    string

    O ID da solicitação.

    F0997EE8-F4C2-4503-9168-85177ED7****

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "MonitorHistory": "\"{\\\"2022-11-06T00:00:00Z\\\":{\\\"memoryUsage\\\":\\\"6.67\\\"},\\\"2022-11-06T00:00:05Z\\\":{\\\"memoryUsage\\\":\\\"6.67\\\"},\\\"2022-11-06T00:00:10Z\\\":{\\\"memoryUsage\\\":\\\"6.67\\\"},\\\"2022-11-06T00:00:15Z\\\":{\\\"memoryUsage\\\":\\\"6.67\\\"},\\\"2022-11-06T00:00:20Z\\\":{\\\"memoryUsage\\\":\\\"6.67\\\"},\\\"2022-11-06T00:00:25Z\\\":{\\\"memoryUsage\\\":\\\"6.67\\\"}}\"",
  "RequestId": "F0997EE8-F4C2-4503-9168-85177ED7****"
}

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição
    400 InvalidStartTime.Malformed The Specified parameter "StartTime" is not valid.
    400 InvalidEndTime.Malformed The Specified parameter "EndTime" is not valid.

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.