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

调用该接口时,实例必须为如下版本:

  • 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异常。

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