查询慢日志统计 - API参考| 阿里云

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

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

说明慢日志统计非实时采集，可能会有6~8小时的延迟。

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	DescribeSlowLogs	系统规定参数，取值：DescribeSlowLogs。
DBInstanceId	String	是	rm-uf6wjk5xxxxxxx	实例ID。
EndTime	String	是	2011-05-30Z	查询结束日期，不能小于查询开始日期，与查询开始日期间隔不超过31天。格式：yyyy-MM-ddZ（UTC时间）。
StartTime	String	是	2011-05-01Z	查询开始日期，格式：yyyy-MM-ddZ（UTC时间）。
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	执行时间（平均值），单位：秒。说明仅SQL Server实例支持返回该参数。
AvgIOWriteCounts	Long	0	I/O写次数（平均值）。说明仅SQL Server实例支持返回该参数。
AvgLastRowsAffectedCounts	Long	0	最后一次受影响的行数（平均值）。说明仅SQL Server实例支持返回该参数。
AvgLogicalReadCounts	Long	0	逻辑读次数（平均值）。说明仅SQL Server实例支持返回该参数。
AvgPhysicalReadCounts	Long	0	物理读次数（平均值）。说明仅SQL Server实例支持返回该参数。
AvgRowsAffectedCounts	Long	0	受影响的行数（平均值）。说明仅SQL Server实例支持返回该参数。
MaxIOWriteCounts	Long	0	I/O写次数（最大值）。说明仅SQL Server实例支持返回该参数。
MaxLastRowsAffectedCounts	Long	0	最后一次受影响的行数（最大值）。说明仅SQL Server实例支持返回该参数。
MaxLogicalReadCounts	Long	0	逻辑读次数（最大值）。说明仅SQL Server实例支持返回该参数。
MaxPhysicalReadCounts	Long	0	物理读次数（最大值）。说明仅SQL Server实例支持返回该参数。
MaxRowsAffectedCounts	Long	0	受影响的行数（最大值）。说明仅SQL Server实例支持返回该参数。
MinIOWriteCounts	Long	0	I/O写次数（最小值）。说明仅SQL Server实例支持返回该参数。
MinLastRowsAffectedCounts	Long	0	最后一次受影响的行数（最小值）。说明仅SQL Server实例支持返回该参数。
MinLogicalReadCounts	Long	0	逻辑读次数（最小值）。说明仅SQL Server实例支持返回该参数。
MinPhysicalReadCounts	Long	0	物理读次数（最小值）。说明仅SQL Server实例支持返回该参数。
MinRowsAffectedCounts	Long	0	受影响的行数（最小值）。说明仅SQL Server实例支持返回该参数。
SQLHASH	String	U2FsdGVkxxxx	慢日志统计里的SQL语句唯一标识符，可用于获取该SQL语句的慢日志明细。
SQLIdStr	String	521584	对应的是慢日志统计模版SQL的ID，现已废弃，请使用SQLHASH。
SQLServerAvgCpuTime	Long	0	CPU查询时间（平均值），单位：秒。说明仅SQL Server实例支持返回该参数。
SQLServerAvgExecutionTime	Long	0	执行时间（平均值），单位：秒。说明仅SQL Server实例支持返回该参数。
SQLServerMaxCpuTime	Long	0	CPU查询时间（最大值），单位：秒。说明仅SQL Server实例支持返回该参数。
SQLServerMinCpuTime	Long	0	CPU查询时间（最小值），单位：秒。说明仅SQL Server实例支持返回该参数。
SQLServerMinExecutionTime	Long	0	执行时间（最小值），单位：秒。说明仅SQL Server实例支持返回该参数。
SQLServerTotalCpuTime	Long	0	CPU查询时间（总值），单位：秒。说明仅SQL Server实例支持返回该参数。
SlowLogId	Long	26584213	慢查询汇总标识ID。
TotalIOWriteCounts	Long	0	I/O写次数（总值）。说明仅SQL Server实例支持返回该参数。
TotalLastRowsAffectedCounts	Long	0	最后一次受影响的行数（总值）。说明仅SQL Server实例支持返回该参数。
TotalLogicalReadCounts	Long	1	逻辑读次数（总值）。
TotalPhysicalReadCounts	Long	1	物理读次数（总值）。
TotalPhysicalReadCounts	Long	1	物理读次数（总值）。
TotalRowsAffectedCounts	Long	0	影响的行数（总值）。
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"
            }
        }
    }
}

错误码


HttpCode	错误码	错误信息	描述
400	InvalidSearchTimeRange	search time range cannot be longer than a month.	查询结束时间（参数名称：EndTime）与查询开始时间（参数名称：StartTime）的间隔应小于31天，请输入正确的相关参数。
400	IO.Exception	IO exception, retry later.	io异常。

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