Todos os produtos
Search

Este produto

    :Consultar métricas de desempenho

    Central de documentação

    :Consultar métricas de desempenho

    Última atualização: Jun 26, 2026

    Chame a operação DescribeDBInstancePerformance para consultar as métricas de desempenho de uma instância.

    Consulte o desempenho de uma instância em um intervalo de tempo específico com base nas métricas de desempenho. O sistema gera essas métricas usando um dos métodos abaixo, conforme o mecanismo e a versão do banco de dados, a edição do RDS, a frequência de monitoramento (ModifyDBInstanceMonitor) e o intervalo de tempo da consulta:

    • Instâncias que não executam MySQL no RDS High-availability Edition com SSDs padrão ou SSDs aprimorados (ESSDs) e instâncias que não executam MariaDB:

      • Frequência de monitoramento de 5 segundos

        • Intervalo de consulta superior a sete dias: coleta a cada 1 dia.

        • Intervalo de consulta superior a um dia e menor ou igual a sete dias: coleta a cada 1 hora.

        • Intervalo de consulta maior ou igual a uma hora e menor ou igual a um dia: coleta a cada 1 minuto.

        • Intervalo de consulta inferior a uma hora: coleta a cada 5 segundos.

      • Frequência de monitoramento de 60 segundos

        • Intervalo de consulta superior a 30 dias: coleta a cada 1 dia.

        • Intervalo de consulta superior a sete dias e menor ou igual a 30 dias: coleta a cada 1 hora.

        • Intervalo de consulta menor ou igual a sete dias: coleta a cada 1 minuto.

      • Frequência de monitoramento de 300 segundos

        • Intervalo de consulta superior a 30 dias: coleta a cada 1 dia.

        • Intervalo de consulta superior a sete dias e menor ou igual a 30 dias: coleta a cada 1 hora.

        • Intervalo de consulta menor ou igual a sete dias: coleta a cada 5 minutos.

    • Instâncias que executam MySQL no RDS High-availability Edition com SSDs padrão ou ESSDs e instâncias que executam MariaDB:

      • Intervalo de consulta superior a 30 dias: coleta a cada 1 dia.

      • Intervalo de consulta superior a sete dias e menor ou igual a 30 dias: coleta a cada 1 hora.

      • Intervalo de consulta menor ou igual a sete dias: coleta a cada 1 minuto.

    • Instâncias que executam PostgreSQL com SSDs locais, SSDs padrão ou ESSDs:

      • Intervalo de consulta menor ou igual a uma hora: coleta a cada 5 segundos.

      • Intervalo de consulta menor ou igual a 2 horas: coleta a cada 10 segundos.

      • Intervalo de consulta menor ou igual a 6 horas: coleta a cada 30 segundos.

      • Intervalo de consulta menor ou igual a 12 horas: coleta a cada 1 minuto.

      • Intervalo de consulta menor ou igual a um dia: coleta a cada 2 minutos.

      • Intervalo de consulta menor ou igual a cinco dias: coleta a cada 10 minutos.

      • Intervalo de consulta menor ou igual a 15 dias: coleta a cada 30 minutos.

      • Intervalo de consulta menor ou igual a 30 dias: coleta a cada 1 hora.

    Depuração

    O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para sua conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

    Parâmetros de solicitação

    ParâmetroTipoObrigatórioExemploDescrição
    ActionStringSimDescribeDBInstancePerformance

    Operação a executar. Defina o valor como DescribeDBInstancePerformance.

    DBInstanceIdStringSim rm-uf6wjk5xxxxxxx

    ID da instância. Chame a operação DescribeDBInstances para consultar o ID da instância.

    KeyStringSimMySQL_Sessions

    Métrica de desempenho a consultar. Separe múltiplas métricas por vírgulas (,). Limite de 30 métricas por solicitação. Para obter mais informações, consulte Parâmetros de desempenho.

    Nota Se definir o parâmetro Key como MySQL_SpaceUsage ou SQLServer_SpaceUsage, você só poderá consultar a métrica de desempenho referente a um único dia.
    StartTimeStringSim2012-06-08T15:00Z

    Início do intervalo de tempo a consultar. Especifique a hora no padrão ISO 8601 no formato aaaa-MM-ddTHH:mmZ. Use o fuso horário UTC.

    Nota A duração entre a hora inicial e a hora final deve exceder a frequência de monitoramento. Caso contrário, a operação pode retornar um array vazio.
    EndTimeStringSim2012-06-18T15:00Z

    Fim do intervalo de tempo a consultar. A hora segue o padrão ISO 8601 no formato aaaa-MM-ddTHH:mmZ. Exibida em UTC.

    Nota A duração entre a hora inicial e a hora final deve exceder a frequência de monitoramento. Caso contrário, a operação pode retornar um array vazio.

    Parâmetros de resposta

    Parâmetro

    Tipo

    Exemplo

    Descrição

    EndTime

    String

    2012-06-19T15:00Z

    Fim do intervalo de tempo consultado. Segue o padrão ISO 8601 no formato aaaa-MM-dd T HH:mm Z. Exibido em UTC.

    StartTime

    String

    2012-06-10T15:00Z

    Início do intervalo de tempo consultado. Segue o padrão ISO 8601 no formato aaaa-MM-dd T HH:mm Z. Exibido em UTC.

    DBInstanceId

    String

    rm-uf6wjk5xxxxxxxxxx

    ID da instância.

    Engine

    String

    MySQL

    Mecanismo de banco de dados da instância.

    RequestId

    String

    A5409D02-D661-4BF3-8F3D-0A814D0574E7

    ID da solicitação.

    PerformanceKeys

    Array of PerformanceKey

    Array composto por métricas de desempenho.

    PerformanceKey

    Key

    String

    MySQL_Sessions

    Nome da métrica de desempenho.

    ValueFormat

    String

    recv_k&sent_k

    Formato de retorno do valor da métrica. Múltiplos valores são separados pela string &. Exemplo: com_delete&com_insert&com_insert_select&com_replace.

    Unit

    String

    KB

    Unidade da métrica de desempenho.

    Values

    Array of PerformanceValue

    Array com os valores da métrica de desempenho no formato: {valor1, valor2, ...}.

    PerformanceValue

    Date

    String

    2011-05-30T03:29:00Z

    Data e hora de registro do valor da métrica. Segue o padrão ISO 8601 no formato aaaa-MM-dd T HH:mm:ss Z. Exibida em UTC.

    Value

    String

    0,0&13,6

    Valor da métrica de desempenho.

    Exemplos

    Solicitações de exemplo

    http(s)://rds.aliyuncs.com/?Action=DescribeDBInstancePerformance
&DBInstanceId= rm-uf6wjk5xxxxxxx
&Key=MySQL_Sessions
&StartTime=2012-06-08T15:00Z
&EndTime=2012-06-18T15:00Z
&<Common request parameters>

    Respostas de sucesso de exemplo

    Formato XML

    HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<DescribeDBInstancePerformanceResponse>
    <RequestId>A5409D02-D661-4BF3-8F3D-0A814D0574E7</RequestId>
    <DBInstanceID> rm-uf6wjk5xxxxxxx</DBInstanceID>
    <StartTime>2012-06-11T15:00Z</StartTime>
    <EndTime>2013-10-17T15:00Z</EndTime>
    <Engine>MySQL</Engine>
    <PerformanceKeys>
        <PerformanceKey>
            <Key>MySQL_NetworkTraffic</Key>
            <Unit>KB</Unit>
            <ValueFormat>recv_k&amp;sent_k</ValueFormat>
            <Values></Values>
        </PerformanceKey>
    </PerformanceKeys>
</DescribeDBInstancePerformanceResponse>

    Formato JSON

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "A5409D02-D661-4BF3-8F3D-0A814D0574E7",
  "DBInstanceID" : " rm-uf6wjk5xxxxxxx",
  "StartTime" : "2012-06-11T15:00Z",
  "EndTime" : "2013-10-17T15:00Z",
  "Engine" : "MySQL",
  "PerformanceKeys" : {
    "PerformanceKey" : [ {
      "Key" : "MySQL_NetworkTraffic",
      "Unit" : "KB",
      "ValueFormat" : "recv_k&sent_k",
      "Values" : {
        "PerformanceValue" : [ ]
      }
    } ]
  }
}

    Códigos de erro

    Para obter uma lista de códigos de erro, visite o API Error Center.