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
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
Parâmetros de solicitação
| Parameter | Type | Required | Example | Description |
| Action | String | Yes | DescribeSlowLogs | A operação a ser executada. Defina o valor como DescribeSlowLogs. |
| DBInstanceId | String | Yes | rm-uf6wjk5xxxxxxx | O ID da instância. |
| StartTime | String | Yes | 2011-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. |
| EndTime | String | Yes | 2011-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. |
| DBName | String | No | RDS_MySQL | O nome do banco de dados. |
| SortKey | String | No | TotalExecutionCounts | A dimensão pela qual o ApsaraDB RDS classifica as entradas retornadas. Valores válidos:
Nota Este parâmetro é suportado apenas para instâncias que executam o SQL Server 2008 R2. |
| PageSize | Integer | No | 30 | O número de entradas a serem retornadas em cada página. Valores válidos: de 30 a 100. Valor padrão: 30. |
| PageNumber | Integer | No | 1 | 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
| Parameter | Type | Example | Description |
| EndTime | String | 2011-05-30Z | A data final do intervalo de tempo consultado. |
| StartTime | String | 2011-05-30Z | A data inicial do intervalo de tempo consultado. |
| RequestId | String | 2553A660-E4EB-4AF4-A402-8AFF70A49143 | O ID da solicitação. |
| PageRecordCount | Integer | 10 | O número de instruções SQL retornadas na página atual. |
| TotalRecordCount | Integer | 5 | O número total de entradas retornadas. |
| DBInstanceId | String | rm-uf6wjk5xxxxxxx | O ID da instância. |
| PageNumber | Integer | 1 | O número da página retornada. |
| Engine | String | MySQL | O mecanismo de banco de dados da instância. |
| Items | Array of SQLSlowLog | Uma matriz composta pelas informações de cada consulta lenta. | |
| SQLSlowLog | |||
| MaxLastRowsAffectedCounts | Long | 0 | 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. |
| ReturnMaxRowCount | Long | 1 | O maior número de linhas retornadas por uma instrução SQL específica na consulta. |
| SQLText | String | select id,name from tb_table | A instrução SQL executada na consulta. |
| SQLServerMaxCpuTime | Long | 0 | 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. |
| CreateTime | String | 2011-05-30Z | A data em que os dados foram gerados. |
| AvgLastRowsAffectedCounts | Long | 0 | 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. |
| MinLastRowsAffectedCounts | Long | 0 | 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. |
| ParseTotalRowCounts | Long | 1 | O número total de linhas analisadas por todas as instruções SQL na consulta. |
| TotalLockTimes | Long | 0 | A duração total de bloqueio causada por todas as instruções SQL na consulta. Unidade: segundos. |
| MySQLTotalExecutionCounts | Long | 1 | O número total de instruções SQL executadas na consulta. Este parâmetro é retornado apenas para instâncias que executam o MySQL. |
| SQLServerMinCpuTime | Long | 0 | 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. |
| SQLHASH | String | U2FsdGVkxxxx | O ID exclusivo da instrução SQL. Esse ID é usado para obter os logs de consultas lentas da instrução SQL. |
| MinIOWriteCounts | Long | 0 | 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. |
| ParseMaxRowCount | Long | 1 | O maior número de linhas analisadas por uma instrução SQL específica na consulta. |
| MaxLogicalReadCounts | Long | 0 | 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. |
| MySQLTotalExecutionTimes | Long | 1 | 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. |
| SQLServerTotalExecutionCounts | Long | 1 | O número total de instruções SQL executadas na consulta. Este parâmetro é retornado apenas para instâncias que executam o SQL Server. |
| ReturnTotalRowCounts | Long | 1 | O número total de linhas retornadas por todas as instruções SQL na consulta. |
| MaxLockTime | Long | 0 | A maior duração de bloqueio causada por uma instrução SQL específica na consulta. Unidade: segundos. |
| DBName | String | RDS_MySQL | O nome do banco de dados. |
| MinRowsAffectedCounts | Long | 0 | 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. |
| TotalLogicalReadCounts | Long | 1 | O número total de leituras lógicas realizadas por todas as instruções SQL na consulta. |
| TotalPhysicalReadCounts | Long | 1 | O número total de leituras físicas realizadas por todas as instruções SQL na consulta. |
| ReportTime | String | 2011-05-30Z | A data em que o relatório de dados foi gerado. |
| MaxPhysicalReadCounts | Long | 0 | 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. |
| SQLServerTotalCpuTime | Long | 0 | 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. |
| TotalIOWriteCounts | Long | 0 | 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. |
| MaxRowsAffectedCounts | Long | 0 | 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. |
| AvgIOWriteCounts | Long | 0 | 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. |
| MinPhysicalReadCounts | Long | 0 | 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. |
| SlowLogId | Long | 26584213 | O ID do resumo do log de consultas lentas. |
| MaxExecutionTime | Long | 60 | A maior duração de execução de uma instrução SQL específica na consulta. Unidade: segundos. |
| AvgExecutionTime | Long | 1 | 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. |
| SQLServerAvgExecutionTime | Long | 0 | 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. |
| MaxIOWriteCounts | Long | 0 | 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. |
| SQLServerAvgCpuTime | Long | 0 | 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. |
| TotalLastRowsAffectedCounts | Long | 0 | 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. |
| AvgLogicalReadCounts | Long | 0 | 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. |
| SQLServerMinExecutionTime | Long | 0 | 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. |
| SQLIdStr | String | 521584 | 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. |
| SQLServerTotalExecutionTimes | Long | 1000 | 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. |
| AvgRowsAffectedCounts | Long | 0 | 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. |
| TotalRowsAffectedCounts | Long | 0 | O número total de linhas afetadas por todas as instruções SQL na consulta. |
| AvgPhysicalReadCounts | Long | 0 | 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. |
| MinLogicalReadCounts | Long | 0 | 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.