调用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

返回数据

名称 类型 示例值 描述
RequestId String 2553A660-E4EB-4AF4-A402-8AFF70A49143

请求ID。

DBInstanceId String rm-uf6wjk5xxxxxxx

实例ID。

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

慢日志信息列表。

SlowLogId Long 26584213

慢查询汇总标识ID。

SQLHASH String U2FsdGVkxxxx

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

SQLIdStr String 521584

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

DBName String RDS_MySQL

数据库名称。

SQLText String select id,name from tb_table

SQL语句。

MySQLTotalExecutionCounts Long 1

MySQL总执行次数。

MySQLTotalExecutionTimes Long 1

MySQL总执行时间,单位:秒。

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

数据生成日期。

SQLServerTotalExecutionCounts Long 1

SQL Server总执行次数。

SQLServerTotalExecutionTimes Long 1000

SQL Server总执行时间,单位:毫秒。

TotalLogicalReadCounts Long 1

总逻辑读。

TotalPhysicalReadCounts Long 1

总物理读。

ReportTime String 2011-05-30Z

数据报表生成日期。

MaxExecutionTime Long 60

最大执行时长,单位:秒。

AvgExecutionTime Long 1

平均执行时间,单位:秒。

示例

请求示例

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 格式

{
    "DescribeSlowLogsResponse": {
        "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"
            }
        }
    }
}

错误码

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