调用DescribeSlowLogRecords接口查看实例的慢日志明细。

说明 本接口的返回参数每分钟更新一次。

调试

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

请求参数

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

系统规定参数。取值:DescribeSlowLogRecords

DBInstanceId String rm-uf6wjk5******

实例ID。

SQLHASH String U2FsdGVk****

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

StartTime String 2020-06-17T16:00Z

查询开始时间。格式:yyyy-MM-ddTHH:mmZ(UTC时间)。

EndTime String 2020-06-18T16:00Z

查询结束时间,需要大于查询开始时间,与查询开始时间间隔小于31天。格式:yyyy-MM-ddTHH:mmZ(UTC时间)。

DBName String RDS_MySQL

数据库名称。

PageSize Integer 30

每页记录数,取值:30~100

说明 默认值:30
PageNumber Integer 1

页码,取值:大于0且不超过Integer的最大值。

说明 默认值:1

返回数据

名称 类型 示例值 描述
PageRecordCount Integer 1

本页SQL语句个数。

RequestId String 4DBB1BB0-E5D8-4D41-B1C9-142364DB****

请求ID。

TotalRecordCount Integer 1

总记录数。

DBInstanceId String rm-uf6wjk5*******

实例ID。

Engine String MySQL

数据库类型。

PageNumber Integer 1

页码。

Items Array of SQLSlowRecord

慢日志明细列表。

SQLSlowRecord
HostAddress String xxx[xxx] @ [1xx.xxx.xxx.xx]

连接数据库的客户端名称及地址。

RowsAffectedCount Long 34

影响行数。

说明 仅SQL Server实例支持。
QueryTimes Long 2

执行时长。单位:秒(s)。

SQLText String select sleep(2)

SQL命令详情。

CpuTime Long 0.002

CPU处理时长。单位:毫秒(ms)。

说明 仅SQL Server实例支持。
QueryTimeMS Long 2001

执行时长。单位:毫秒(ms)。

ApplicationName String example

连接的应用名称。

说明 仅SQL Server实例支持。
LockTimes Long 0

锁定时长。单位:秒(s)。

ExecutionStartTime String 2020-06-18T01:40:44Z

执行开始时间。格式:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

LogicalIORead Long 383

逻辑读次数。

说明 仅SQL Server实例支持。
WriteIOCount Long 22

I/O写入次数。

说明 仅SQL Server实例支持。
PhysicalIORead Long 200

物理读次数。

说明 仅SQL Server实例支持。
ReturnRowCounts Long 1

返回行数。

ParseRowCounts Long 1

解析行数。

DBName String testDB

数据库名称。

ClientHostName String example

客户端主机名。

说明 仅SQL Server实例支持。
UserName String user

用户名。

说明 仅SQL Server实例支持。
LastRowsAffectedCount Long 2

最后一条语句的影响行数。

说明 仅SQL Server实例支持。
SQLHash String U2FsdGVk****

慢日志明细里的SQL语句唯一标识符。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=DescribeSlowLogRecords
&DBInstanceId=rm-uf6wjk5*******
&StartTime=2020-06-17T16:00Z
&EndTime=2020-06-18T16:00Z
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeSlowLogRecordsResponse>
    <PageRecordCount>1</PageRecordCount>
    <RequestId>4DBB1BB0-E5D8-4D41-B1C9-142364DB****</RequestId>
    <TotalRecordCount>1</TotalRecordCount>
    <DBInstanceId>rm-uf6wjk5*******</DBInstanceId>
    <Engine>MySQL</Engine>
    <PageNumber>1</PageNumber>
    <Items>
        <HostAddress>xxx[xxx] @  [1xx.xxx.xxx.xx]</HostAddress>
        <RowsAffectedCount>34</RowsAffectedCount>
        <QueryTimes>2</QueryTimes>
        <SQLText>select sleep(2)</SQLText>
        <QueryTimeMS>2001</QueryTimeMS>
        <ApplicationName>example</ApplicationName>
        <LockTimes>0</LockTimes>
        <ExecutionStartTime>2020-06-18T01:40:44Z</ExecutionStartTime>
        <LogicalIORead>383</LogicalIORead>
        <WriteIOCount>22</WriteIOCount>
        <PhysicalIORead>200</PhysicalIORead>
        <ReturnRowCounts>1</ReturnRowCounts>
        <ParseRowCounts>1</ParseRowCounts>
        <DBName>testDB</DBName>
        <ClientHostName>example</ClientHostName>
        <UserName>user</UserName>
        <LastRowsAffectedCount>2</LastRowsAffectedCount>
        <SQLHash>U2FsdGVk****</SQLHash>
    </Items>
</DescribeSlowLogRecordsResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "PageRecordCount" : 1,
  "RequestId" : "4DBB1BB0-E5D8-4D41-B1C9-142364DB****",
  "TotalRecordCount" : 1,
  "DBInstanceId" : "rm-uf6wjk5*******",
  "Engine" : "MySQL",
  "PageNumber" : 1,
  "Items" : [ {
    "HostAddress" : "xxx[xxx] @  [1xx.xxx.xxx.xx]",
    "RowsAffectedCount" : 34,
    "QueryTimes" : 2,
    "SQLText" : "select sleep(2)",
    "QueryTimeMS" : 2001,
    "ApplicationName" : "example",
    "LockTimes" : 0,
    "ExecutionStartTime" : "2020-06-18T01:40:44Z",
    "LogicalIORead" : 383,
    "WriteIOCount" : 22,
    "PhysicalIORead" : 200,
    "ReturnRowCounts" : 1,
    "ParseRowCounts" : 1,
    "DBName" : "testDB",
    "ClientHostName" : "example",
    "UserName" : "user",
    "LastRowsAffectedCount" : 2,
    "SQLHash" : "U2FsdGVk****"
  } ]
}

错误码

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

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