调用DescribeSlowLogs查询慢日志统计情况。

调用该接口时，实例必须为如下版本：

  • MySQL所有版本（MySQL 5.7基础版除外）；
  • SQL Server 2008 R2；
  • MariaDB 10.3。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeSlowLogs

系统规定参数，取值：DescribeSlowLogs。

DBInstanceId String 是 rm-uf6wjk5xxxxxxx

实例ID。
EndTime String 是 2011-05-30Z

查询结束日期，不能小于查询开始日期，与查询开始日期间隔不超过31天。格式：yyyy-MM-ddZ。

StartTime String 是 2011-05-01Z

查询开始日期，格式：yyyy-MM-ddZ。

DBName String 否 RDS_MySQL

数据库名称。
SortKey String 否 TotalExecutionCounts

排序依据，取值：

  • TotalExecutionCounts：总执行次数最多
  • TotalQueryTimes：总执行时间最多
  • TotalLogicalReads：总逻辑读最多
  • TotalPhysicalReads：总物理读最多
说明 仅SQL Server 2008 R2实例支持本参数。
PageSize Integer 否 30

每页记录数，取值：30~100。默认值：30。

PageNumber Integer 否 1

页码，取值：大于0且不超过Integer的最大值。

默认值：1。

返回数据

名称 类型 示例值 描述
Engine String MySQL

数据库类型。
StartTime String 2011-05-30Z

查询开始日期。
EndTime String 2011-05-30Z

查询结束日期。
TotalRecordCount Integer 5

总记录数。
PageNumber Integer 1

页码。
PageRecordCount Integer 10

本页SQL语句个数。
Items Array of SQLSlowLog

慢日志信息列表。
SQLSlowLog
DBName String RDS_MySQL

数据库名称。
SQLText String select id,name from tb_table

SQL语句。
SQLServerTotalExecutionCounts Long 1

SQL Server总执行次数。
MySQLTotalExecutionCounts Long 1

MySQL总执行次数。
SQLServerTotalExecutionTimes Long 1000

SQL Server总执行时间，单位：毫秒。
MySQLTotalExecutionTimes Long 1

MySQL总执行时间，单位：秒。
MaxExecutionTime Long 60

最大执行时长，单位：秒。
ReportTime String 2011-05-30Z

数据报表生成日期。
TotalLockTimes Long 0

锁定总时长，单位：秒。
MaxLockTime Long 0

最大锁定时长，单位：秒。
ParseTotalRowCounts Long 1

解析SQL总行数。
ParseMaxRowCount Long 1

解析SQL最大行数。
ReturnTotalRowCounts Long 1

返回SQL总行数。
ReturnMaxRowCount Long 1

返回SQL最大行数。
CreateTime String 2011-05-30Z

数据生成日期。
AvgExecutionTime Long 1

平均执行时间，单位：秒。
SQLHASH String U2FsdGVkxxxx

慢日志统计里的SQL语句唯一标识符，可用于获取该SQL语句的慢日志明细。
SQLIdStr String 521584

对应的是慢日志统计模版SQL的ID，现已废弃，请使用SQLHASH。

SlowLogId Long 26584213

慢查询汇总标识ID。
TotalLogicalReadCounts Long 1

总逻辑读。
TotalPhysicalReadCounts Long 1

总物理读。
DBInstanceId String rm-uf6wjk5xxxxxxx

实例ID。
RequestId String 2553A660-E4EB-4AF4-A402-8AFF70A49143

请求ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=DescribeSlowLogs
&DBInstanceId=rm-uf6wjk5xxxxxxx
&StartTime=2011-05-01Z
&EndTime=2011-05-30Z
&<公共请求参数>

正常返回示例

XML 格式 

<DescribeSlowLogsResponse> 
    <RequestId>A5409D02-D661-4BF3-8F3D-0A814D0574E7</RequestId>
    <DBInstanceID>rm-uf6wjk5xxxxxxx</DBInstanceID> 
    <Engine>SQLServer</Engine>
    <StartTime>2011-06-11Z</StartTime> 
    <EndTime>2011-12-11Z</EndTime> 
    <TotalRecordCount>1</TotalRecordCount>
    <PageNumber>1</PageNumber>
    <PageRecordCount>1</PageRecordCount>
    <Items>
        <SQLSlowLog>
          <SQLText>update test.zxb set id=0 limit 1</SQLText>
          <SQLServerTotalExecutionCounts>178</SQLServerTotalExecutionCounts>
          <SQLServerTotalExecutionTimes>189</SQLServerTotalExecutionTimes>
          <TotalLogicalReadcounts>89</TotalLogicalReadcounts>
          <TotalPhysicalReadcounts>90</TotalPhysicalReadcounts>
          <ReportTime>2013-11-12Z</ReportTime>
       </SQLSlowLog>
    </Items>
</DescribeSlowLogsResponse>

JSON 格式 

{
    "DescribeSlowLogs": {
        "RequestId": "A5409D02-D661-4BF3-8F3D-0A814D0574E7",
        "DBInstanceID": "rm-uf6wjk5xxxxxxx",
        "Engine": "SQLServer",
        "StartTime": "2011-06-11Z",
        "EndTime": "2011-12-11Z",
        "TotalRecordCount": "1",
        "PageNumber": "1",
        "PageRecordCount": "1",
        "Items": {
            "SQLSlowLog": {
                "SQLText": "update test.zxb set id=0 limit 1",
                "SQLServerTotalExecutionCounts": "178",
                "SQLServerTotalExecutionTimes": "189",
                "TotalLogicalReadcounts": "89",
                "TotalPhysicalReadcounts": "90",
                "ReportTime": "2013-11-12Z"
            }
        }
    }
}

错误码

访问错误中心查看更多错误码。