Todos os produtos
Search
Central de documentação

:Consultar o resumo de logs de consultas lentas

Última atualização: Jun 26, 2026

Chame a operação DescribeSlowLogs para consultar o resumo dos logs de consultas lentas de uma instância.

Antes de chamar esta operação, verifique se a instância executa uma das seguintes versões de mecanismo de banco de dados:

  • Todas as versões do MySQL, exceto o MySQL 5.7 no RDS Basic Edition

  • SQL Server 2008 R2

  • MariaDB 10.3

Nota

Os logs de consultas lentas não são coletados em tempo real e podem apresentar latência de 6 a 8 horas.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

ParameterTypeRequiredExampleDescription
ActionStringYesDescribeSlowLogs

A operação a ser executada. Defina o valor como DescribeSlowLogs.

DBInstanceIdStringYesrm-uf6wjk5xxxxxxx

O ID da instância.

StartTimeStringYes2011-05-01Z

O início do intervalo de tempo a ser consultado. Especifique a hora no padrão ISO 8601 no formato aaaa-MM-ddZ. A hora deve estar em UTC.

EndTimeStringYes2011-05-30Z

O fim do intervalo de tempo a ser consultado. A hora final deve ser posterior à hora inicial. O intervalo entre a hora inicial e a hora final não pode exceder 31 dias. Especifique a hora no padrão ISO 8601 no formato aaaa-MM-ddZ. A hora deve estar em UTC.

DBNameStringNoRDS_MySQL

O nome do banco de dados.

SortKeyStringNoTotalExecutionCounts

A dimensão pela qual o ApsaraDB RDS classifica as entradas retornadas. Valores válidos:

  • TotalExecutionCounts: classificação com base no número de execuções das instruções SQL.
  • TotalQueryTimes: classificação com base na duração total da execução.
  • TotalLogicalReads: classificação com base no número total de leituras lógicas.
  • TotalPhysicalReads: classificação com base no número total de leituras físicas.
Nota Este parâmetro é suportado apenas para instâncias que executam o SQL Server 2008 R2.
PageSizeIntegerNo30

O número de entradas a serem retornadas em cada página. Valores válidos: de 30 a 100. Valor padrão: 30.

PageNumberIntegerNo1

O número da página a ser retornada. Valores válidos: qualquer número inteiro positivo diferente de zero.

Valor padrão: 1.

Parâmetros de resposta

ParameterTypeExampleDescription
EndTimeString2011-05-30Z

A data final do intervalo de tempo consultado.

StartTimeString2011-05-30Z

A data inicial do intervalo de tempo consultado.

RequestIdString2553A660-E4EB-4AF4-A402-8AFF70A49143

O ID da solicitação.

PageRecordCountInteger10

O número de instruções SQL retornadas na página atual.

TotalRecordCountInteger5

O número total de entradas retornadas.

DBInstanceIdStringrm-uf6wjk5xxxxxxx

O ID da instância.

PageNumberInteger1

O número da página retornada.

EngineStringMySQL

O mecanismo de banco de dados da instância.

ItemsArray of SQLSlowLog

Uma matriz composta pelas informações de cada consulta lenta.

SQLSlowLog
MaxLastRowsAffectedCountsLong0

O maior número de linhas afetadas pela última instrução SQL na consulta.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
ReturnMaxRowCountLong1

O maior número de linhas retornadas por uma instrução SQL específica na consulta.

SQLTextStringselect id,name from tb_table

A instrução SQL executada na consulta.

SQLServerMaxCpuTimeLong0

A maior quantidade de tempo de CPU usada por uma instrução SQL específica na consulta. Unidade: segundos.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
CreateTimeString2011-05-30Z

A data em que os dados foram gerados.

AvgLastRowsAffectedCountsLong0

O número médio de linhas afetadas pela última instrução SQL na consulta.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
MinLastRowsAffectedCountsLong0

O menor número de linhas afetadas pela última instrução SQL na consulta.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
ParseTotalRowCountsLong1

O número total de linhas analisadas por todas as instruções SQL na consulta.

TotalLockTimesLong0

A duração total de bloqueio causada por todas as instruções SQL na consulta. Unidade: segundos.

MySQLTotalExecutionCountsLong1

O número total de instruções SQL executadas na consulta. Este parâmetro é retornado apenas para instâncias que executam o MySQL.

SQLServerMinCpuTimeLong0

A menor quantidade de tempo de CPU usada por uma instrução SQL específica. Unidade: segundos.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
SQLHASHStringU2FsdGVkxxxx

O ID exclusivo da instrução SQL. Esse ID é usado para obter os logs de consultas lentas da instrução SQL.

MinIOWriteCountsLong0

O menor número de gravações de E/S realizadas por uma instrução SQL específica na consulta.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
ParseMaxRowCountLong1

O maior número de linhas analisadas por uma instrução SQL específica na consulta.

MaxLogicalReadCountsLong0

O maior número de leituras lógicas realizadas por uma instrução SQL específica na consulta.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
MySQLTotalExecutionTimesLong1

A duração total da execução de todas as instruções SQL na consulta. Este parâmetro é retornado apenas para instâncias que executam o MySQL. Unidade: segundos.

SQLServerTotalExecutionCountsLong1

O número total de instruções SQL executadas na consulta. Este parâmetro é retornado apenas para instâncias que executam o SQL Server.

ReturnTotalRowCountsLong1

O número total de linhas retornadas por todas as instruções SQL na consulta.

MaxLockTimeLong0

A maior duração de bloqueio causada por uma instrução SQL específica na consulta. Unidade: segundos.

DBNameStringRDS_MySQL

O nome do banco de dados.

MinRowsAffectedCountsLong0

O menor número de linhas afetadas por uma instrução SQL específica na consulta.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
TotalLogicalReadCountsLong1

O número total de leituras lógicas realizadas por todas as instruções SQL na consulta.

TotalPhysicalReadCountsLong1

O número total de leituras físicas realizadas por todas as instruções SQL na consulta.

ReportTimeString2011-05-30Z

A data em que o relatório de dados foi gerado.

MaxPhysicalReadCountsLong0

O maior número de leituras físicas realizadas por uma instrução SQL específica na consulta.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
SQLServerTotalCpuTimeLong0

A quantidade total de tempo de CPU usada por todas as instruções SQL na consulta. Unidade: segundos.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
TotalIOWriteCountsLong0

O número total de gravações de E/S realizadas por todas as instruções SQL na consulta.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
MaxRowsAffectedCountsLong0

O maior número de linhas afetadas por uma instrução SQL específica na consulta.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
AvgIOWriteCountsLong0

O número médio de gravações de E/S por instrução SQL na consulta.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
MinPhysicalReadCountsLong0

O menor número de leituras físicas realizadas por uma instrução SQL específica na consulta.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
SlowLogIdLong26584213

O ID do resumo do log de consultas lentas.

MaxExecutionTimeLong60

A maior duração de execução de uma instrução SQL específica na consulta. Unidade: segundos.

AvgExecutionTimeLong1

A duração média de execução por instrução SQL na consulta. Unidade: segundos.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
SQLServerAvgExecutionTimeLong0

A duração média de execução por instrução SQL na consulta. Unidade: segundos.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
MaxIOWriteCountsLong0

O maior número de gravações de E/S realizadas por uma instrução SQL específica na consulta.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
SQLServerAvgCpuTimeLong0

A quantidade média de tempo de CPU por instrução SQL na consulta. Unidade: segundos.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
TotalLastRowsAffectedCountsLong0

O número total de linhas afetadas pela última instrução SQL na consulta.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
AvgLogicalReadCountsLong0

O número médio de leituras lógicas por instrução SQL na consulta.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
SQLServerMinExecutionTimeLong0

A menor duração de execução de uma instrução SQL específica na consulta. Unidade: segundos.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
SQLIdStrString521584

O ID da instrução SQL no modelo estatístico de logs de consultas lentas. Este parâmetro foi substituído pelo parâmetro SQLHASH.

SQLServerTotalExecutionTimesLong1000

A duração total da execução de todas as instruções SQL na consulta. Este parâmetro é retornado apenas para instâncias que executam o SQL Server. Unidade: milissegundos.

AvgRowsAffectedCountsLong0

O número médio de linhas afetadas por instrução SQL na consulta.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
TotalRowsAffectedCountsLong0

O número total de linhas afetadas por todas as instruções SQL na consulta.

AvgPhysicalReadCountsLong0

O número médio de leituras físicas por instrução SQL na consulta.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.
MinLogicalReadCountsLong0

O menor número de leituras lógicas realizadas por uma instrução SQL específica na consulta.

Nota Este parâmetro é retornado apenas para instâncias que executam o SQL Server.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=DescribeSlowLogs
&DBInstanceId=rm-uf6wjk5xxxxxxx
&StartTime=2011-05-01Z
&EndTime=2011-05-30Z
&<Common request parameters>

Exemplo de resposta de sucesso

XML formato

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

<DescribeSlowLogsResponse>
    <EndTime>2011-05-30Z</EndTime>
    <StartTime>2011-05-30Z</StartTime>
    <RequestId>2553A660-E4EB-4AF4-A402-8AFF70A49143</RequestId>
    <PageRecordCount>10</PageRecordCount>
    <TotalRecordCount>5</TotalRecordCount>
    <DBInstanceId>rm-uf6wjk5xxxxxxx</DBInstanceId>
    <PageNumber>1</PageNumber>
    <Engine>MySQL</Engine>
    <Items>
        <MaxLastRowsAffectedCounts>0</MaxLastRowsAffectedCounts>
        <ReturnMaxRowCount>1</ReturnMaxRowCount>
        <SQLText>select id,name from tb_table</SQLText>
        <SQLServerMaxCpuTime>0</SQLServerMaxCpuTime>
        <CreateTime>2011-05-30Z</CreateTime>
        <AvgLastRowsAffectedCounts>0</AvgLastRowsAffectedCounts>
        <MinLastRowsAffectedCounts>0</MinLastRowsAffectedCounts>
        <ParseTotalRowCounts>1</ParseTotalRowCounts>
        <TotalLockTimes>0</TotalLockTimes>
        <MySQLTotalExecutionCounts>1</MySQLTotalExecutionCounts>
        <SQLServerMinCpuTime>0</SQLServerMinCpuTime>
        <SQLHASH>U2FsdGVkxxxx</SQLHASH>
        <MinIOWriteCounts>0</MinIOWriteCounts>
        <ParseMaxRowCount>1</ParseMaxRowCount>
        <MaxLogicalReadCounts>0</MaxLogicalReadCounts>
        <MySQLTotalExecutionTimes>1</MySQLTotalExecutionTimes>
        <SQLServerTotalExecutionCounts>1</SQLServerTotalExecutionCounts>
        <ReturnTotalRowCounts>1</ReturnTotalRowCounts>
        <MaxLockTime>0</MaxLockTime>
        <DBName>RDS_MySQL</DBName>
        <MinRowsAffectedCounts>0</MinRowsAffectedCounts>
        <TotalLogicalReadCounts>1</TotalLogicalReadCounts>
        <TotalPhysicalReadCounts>1</TotalPhysicalReadCounts>
        <ReportTime>2011-05-30Z</ReportTime>
        <MaxPhysicalReadCounts>0</MaxPhysicalReadCounts>
        <SQLServerTotalCpuTime>0</SQLServerTotalCpuTime>
        <TotalIOWriteCounts>0</TotalIOWriteCounts>
        <MaxRowsAffectedCounts>0</MaxRowsAffectedCounts>
        <AvgIOWriteCounts>0</AvgIOWriteCounts>
        <MinPhysicalReadCounts>0</MinPhysicalReadCounts>
        <SlowLogId>26584213</SlowLogId>
        <MaxExecutionTime>60</MaxExecutionTime>
        <AvgExecutionTime>1</AvgExecutionTime>
        <SQLServerAvgExecutionTime>0</SQLServerAvgExecutionTime>
        <MaxIOWriteCounts>0</MaxIOWriteCounts>
        <SQLServerAvgCpuTime>0</SQLServerAvgCpuTime>
        <TotalLastRowsAffectedCounts>0</TotalLastRowsAffectedCounts>
        <AvgLogicalReadCounts>0</AvgLogicalReadCounts>
        <SQLServerMinExecutionTime>0</SQLServerMinExecutionTime>
        <SQLIdStr>521584</SQLIdStr>
        <SQLServerTotalExecutionTimes>1000</SQLServerTotalExecutionTimes>
        <AvgRowsAffectedCounts>0</AvgRowsAffectedCounts>
        <TotalRowsAffectedCounts>0</TotalRowsAffectedCounts>
        <AvgPhysicalReadCounts>0</AvgPhysicalReadCounts>
        <MinLogicalReadCounts>0</MinLogicalReadCounts>
    </Items>
</DescribeSlowLogsResponse>

JSON formato

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

{
  "EndTime" : "2011-05-30Z",
  "StartTime" : "2011-05-30Z",
  "RequestId" : "2553A660-E4EB-4AF4-A402-8AFF70A49143",
  "PageRecordCount" : 10,
  "TotalRecordCount" : 5,
  "DBInstanceId" : "rm-uf6wjk5xxxxxxx",
  "PageNumber" : 1,
  "Engine" : "MySQL",
  "Items" : [ {
    "MaxLastRowsAffectedCounts" : 0,
    "ReturnMaxRowCount" : 1,
    "SQLText" : "select id,name from tb_table",
    "SQLServerMaxCpuTime" : 0,
    "CreateTime" : "2011-05-30Z",
    "AvgLastRowsAffectedCounts" : 0,
    "MinLastRowsAffectedCounts" : 0,
    "ParseTotalRowCounts" : 1,
    "TotalLockTimes" : 0,
    "MySQLTotalExecutionCounts" : 1,
    "SQLServerMinCpuTime" : 0,
    "SQLHASH" : "U2FsdGVkxxxx",
    "MinIOWriteCounts" : 0,
    "ParseMaxRowCount" : 1,
    "MaxLogicalReadCounts" : 0,
    "MySQLTotalExecutionTimes" : 1,
    "SQLServerTotalExecutionCounts" : 1,
    "ReturnTotalRowCounts" : 1,
    "MaxLockTime" : 0,
    "DBName" : "RDS_MySQL",
    "MinRowsAffectedCounts" : 0,
    "TotalLogicalReadCounts" : 1,
    "TotalPhysicalReadCounts" : 1,
    "ReportTime" : "2011-05-30Z",
    "MaxPhysicalReadCounts" : 0,
    "SQLServerTotalCpuTime" : 0,
    "TotalIOWriteCounts" : 0,
    "MaxRowsAffectedCounts" : 0,
    "AvgIOWriteCounts" : 0,
    "MinPhysicalReadCounts" : 0,
    "SlowLogId" : 26584213,
    "MaxExecutionTime" : 60,
    "AvgExecutionTime" : 1,
    "SQLServerAvgExecutionTime" : 0,
    "MaxIOWriteCounts" : 0,
    "SQLServerAvgCpuTime" : 0,
    "TotalLastRowsAffectedCounts" : 0,
    "AvgLogicalReadCounts" : 0,
    "SQLServerMinExecutionTime" : 0,
    "SQLIdStr" : "521584",
    "SQLServerTotalExecutionTimes" : 1000,
    "AvgRowsAffectedCounts" : 0,
    "TotalRowsAffectedCounts" : 0,
    "AvgPhysicalReadCounts" : 0,
    "MinLogicalReadCounts" : 0
  } ]
}

Códigos de erro

HTTP status code

Error code

Error message

Description

400

InvalidSearchTimeRange

search time range cannot be longer than a month.

Mensagem de erro retornada porque o intervalo entre a hora inicial e a hora final excede 31 dias. Insira um valor válido para o parâmetro StartTime ou EndTime.

400

IO.Exception

IO exception, retry later.

Mensagem de erro retornada devido à ocorrência de erros de E/S.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.