调用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(UTC时间)。 |
StartTime | String | 是 | 2011-05-01Z |
查询开始日期,格式:yyyy-MM-ddZ(UTC时间)。 |
DBName | String | 否 | RDS_MySQL |
数据库名称。 |
SortKey | String | 否 | TotalExecutionCounts |
排序依据,取值:
说明 仅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异常。 |
访问错误中心查看更多错误码。