全部产品
Search
文档中心

云数据库 RDS:DescribeSlowLogs - 查看慢日志统计情况

更新时间:Mar 13, 2024

该接口用于查询慢日志统计情况。

接口说明

适用引擎

  • RDS MySQL
    说明 MySQL 5.7 基础版暂不支持。
  • RDS SQL Server
    说明 仅支持 SQL Server 2008 R2 版本。
  • RDS MariaDB

注意事项

  • 慢日志统计非实时采集,可能会有 6~8 小时的延迟。
  • 如果返回结果为空,请检查 StartTime 和 EndTime 配置是否符合 UTC 格式要求,如果满足,则表示该时间段内无慢日志。
  • 2023 年 12 月 13 日起,由于慢 SQL 的模板化算法优化,调用本接口时,SQLHash 字段的值将发生变更。详情请参见【通知】慢 SQL 的模板化算法优化

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
rds:DescribeSlowLogsREAD
  • DBInstance
    acs:rds:{#regionId}:{#accountId}:dbinstance/{#dbinstanceId}
  • rds:ResourceTag

请求参数

名称类型必填描述示例值
DBInstanceIdstring

实例 ID。可调用 DescribeDBInstances 获取。

rm-uf6wjk5****
StartTimestring

查询开始日期,格式:yyyy-MM-ddZ(UTC 时间)。

2011-05-01Z
EndTimestring

查询结束日期,不能小于查询开始日期,与查询开始日期间隔不超过 31 天。格式:yyyy-MM-ddZ(UTC 时间)。

2011-05-30Z
DBNamestring

数据库名称。

RDS_MySQL
SortKeystring

排序依据,取值:

  • TotalExecutionCounts:总执行次数最多
  • TotalQueryTimes:总执行时间最多
  • TotalLogicalReads:总逻辑读最多
  • TotalPhysicalReads:总物理读最多
说明 仅 SQL Server 2008 R2 实例支持本参数。
TotalExecutionCounts
PageSizeinteger

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

30
PageNumberinteger

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

默认值:1

1

返回参数

名称类型描述示例值
object

返回参数详情。

EndTimestring

查询结束日期。

2011-05-30Z
StartTimestring

查询开始日期。

2011-05-30Z
RequestIdstring

请求 ID。

2553A660-E4EB-4AF4-A402-8AFF70A49143
PageRecordCountinteger

本页 SQL 语句个数。

10
TotalRecordCountinteger

总记录数。

5
DBInstanceIdstring

实例 ID。

rm-uf6wjk5****
PageNumberinteger

页码。

1
Enginestring

数据库类型。

MySQL
Itemsobject []

慢日志信息列表。

MaxLastRowsAffectedCountslong

最后一次受影响的行数(最大值)。

说明 仅 SQL Server 实例支持返回该参数。
0
ReturnMaxRowCountlong

返回的 SQL 行数(最大值)。

1
SQLTextstring

SQL 语句。

select id,name from tb_table
SQLServerMaxCpuTimelong

CPU 查询时间(最大值),单位:秒。

说明 仅 SQL Server 实例支持返回该参数。
0
CreateTimestring

数据生成日期。

2011-05-30Z
AvgLastRowsAffectedCountslong

最后一次受影响的行数(平均值)。

说明 仅 SQL Server 实例支持返回该参数。
0
MinLastRowsAffectedCountslong

最后一次受影响的行数(最小值)。

说明 仅 SQL Server 实例支持返回该参数。
0
ParseTotalRowCountslong

解析的 SQL 行数(总值)。

1
TotalLockTimeslong

锁定时长(总值),单位:秒。

0
MySQLTotalExecutionCountslong

MySQL 执行次数(总值)。

1
SQLServerMinCpuTimelong

CPU 查询时间(最小值),单位:秒。

说明 仅 SQL Server 实例支持返回该参数。
0
SQLHASHstring

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

U2FsdGVk****
MinIOWriteCountslong

I/O 写次数(最小值)。

说明 仅 SQL Server 实例支持返回该参数。
0
ParseMaxRowCountlong

解析的 SQL 行数(最大值)。

1
MaxLogicalReadCountslong

逻辑读次数(最大值)。

说明 仅 SQL Server 实例支持返回该参数。
0
MySQLTotalExecutionTimeslong

MySQL 执行时长(总值),单位:秒。

1
SQLServerTotalExecutionCountslong

SQL Server 执行次数(总值)。

1
ReturnTotalRowCountslong

返回的 SQL 行数(总值)。

1
MaxLockTimelong

锁定时长(最大值),单位:秒。

0
MaxLockTimeMSlong

锁定时长(最大值),单位:毫秒。

1000
DBNamestring

数据库名称。

RDS_MySQL
MinRowsAffectedCountslong

受影响的行数(最小值)。

说明 仅 SQL Server 实例支持返回该参数。
0
TotalLogicalReadCountslong

逻辑读次数(总值)。

1
TotalPhysicalReadCountslong

物理读次数(总值)。

1
ReportTimestring

数据报表生成日期。

2011-05-30Z
MaxPhysicalReadCountslong

物理读次数(最大值)。

说明 仅 SQL Server 实例支持返回该参数。
0
SQLServerTotalCpuTimelong

CPU 查询时间(总值),单位:秒。

说明 仅 SQL Server 实例支持返回该参数。
0
TotalIOWriteCountslong

I/O 写次数(总值)。

说明 仅 SQL Server 实例支持返回该参数。
0
MaxRowsAffectedCountslong

受影响的行数(最大值)。

说明 仅 SQL Server 实例支持返回该参数。
0
AvgIOWriteCountslong

I/O 写次数(平均值)。

说明 仅 SQL Server 实例支持返回该参数。
0
MinPhysicalReadCountslong

物理读次数(最小值)。

说明 仅 SQL Server 实例支持返回该参数。
0
SlowLogIdlong

慢查询汇总标识 ID。

26584213
MaxExecutionTimelong

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

60
MaxExecutionTimeMSlong

执行时长(最大值),单位:毫秒。

60000
AvgExecutionTimelong

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

说明 仅 SQL Server 实例支持返回该参数。
1
SQLServerAvgExecutionTimelong

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

说明 仅 SQL Server 实例支持返回该参数。
0
MaxIOWriteCountslong

I/O 写次数(最大值)。

说明 仅 SQL Server 实例支持返回该参数。
0
SQLServerAvgCpuTimelong

CPU 查询时间(平均值),单位:秒。

说明 仅 SQL Server 实例支持返回该参数。
0
TotalLastRowsAffectedCountslong

最后一次受影响的行数(总值)。

说明 仅 SQL Server 实例支持返回该参数。
0
AvgLogicalReadCountslong

逻辑读次数(平均值)。

说明 仅 SQL Server 实例支持返回该参数。
0
SQLServerMinExecutionTimelong

执行时间(最小值),单位:秒。

说明 仅 SQL Server 实例支持返回该参数。
0
SQLIdStrstring

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

521584
SQLServerTotalExecutionTimeslong

SQL Server 执行时长(总值),单位:毫秒。

1000
AvgRowsAffectedCountslong

受影响的行数(平均值)。

说明 仅 SQL Server 实例支持返回该参数。
0
TotalRowsAffectedCountslong

影响的行数(总值)。

0
AvgPhysicalReadCountslong

物理读次数(平均值)。

说明 仅 SQL Server 实例支持返回该参数。
0
MinLogicalReadCountslong

逻辑读次数(最小值)。

说明 仅 SQL Server 实例支持返回该参数。
0

示例

正常返回示例

JSON格式

{
  "EndTime": "2011-05-30Z",
  "StartTime": "2011-05-30Z",
  "RequestId": "2553A660-E4EB-4AF4-A402-8AFF70A49143",
  "PageRecordCount": 10,
  "TotalRecordCount": 5,
  "DBInstanceId": "rm-uf6wjk5****",
  "PageNumber": 1,
  "Engine": "MySQL",
  "Items": {
    "SQLSlowLog": [
      {
        "MaxLastRowsAffectedCounts": 0,
        "ReturnMaxRowCount": 1,
        "SQLText": "select id,name from tb_table",
        "SQLServerMaxCpuTime": 0,
        "CreateTime": "2011-05-30Z",
        "AvgLastRowsAffectedCounts": 0,
        "MinLastRowsAffectedCounts": 0,
        "ParseTotalRowCounts": 1,
        "TotalLockTimes": 0,
        "MySQLTotalExecutionCounts": 1,
        "SQLServerMinCpuTime": 0,
        "SQLHASH": "U2FsdGVk****",
        "MinIOWriteCounts": 0,
        "ParseMaxRowCount": 1,
        "MaxLogicalReadCounts": 0,
        "MySQLTotalExecutionTimes": 1,
        "SQLServerTotalExecutionCounts": 1,
        "ReturnTotalRowCounts": 1,
        "MaxLockTime": 0,
        "MaxLockTimeMS": 1000,
        "DBName": "RDS_MySQL",
        "MinRowsAffectedCounts": 0,
        "TotalLogicalReadCounts": 1,
        "TotalPhysicalReadCounts": 1,
        "ReportTime": "2011-05-30Z",
        "MaxPhysicalReadCounts": 0,
        "SQLServerTotalCpuTime": 0,
        "TotalIOWriteCounts": 0,
        "MaxRowsAffectedCounts": 0,
        "AvgIOWriteCounts": 0,
        "MinPhysicalReadCounts": 0,
        "SlowLogId": 26584213,
        "MaxExecutionTime": 60,
        "MaxExecutionTimeMS": 60000,
        "AvgExecutionTime": 1,
        "SQLServerAvgExecutionTime": 0,
        "MaxIOWriteCounts": 0,
        "SQLServerAvgCpuTime": 0,
        "TotalLastRowsAffectedCounts": 0,
        "AvgLogicalReadCounts": 0,
        "SQLServerMinExecutionTime": 0,
        "SQLIdStr": "521584",
        "SQLServerTotalExecutionTimes": 1000,
        "AvgRowsAffectedCounts": 0,
        "TotalRowsAffectedCounts": 0,
        "AvgPhysicalReadCounts": 0,
        "MinLogicalReadCounts": 0
      }
    ]
  }
}

错误码

HTTP status code错误码错误信息描述
400InvalidSearchTimeRangesearch time range cannot be longer than a month.查询结束时间(参数名称:EndTime)与查询开始时间(参数名称:StartTime)的间隔应小于31天,请输入正确的相关参数。
400IO.ExceptionIO exception, retry later.io异常。
400SortKey.ValueNotSupportedSortKey.ValueNotSupported-
400Order.ComboInstanceNotAllowOperateA package instance is not allowed to operate independently.套餐实例不允许单独操作。
400Price.PricingPlanResultNotFoundPricing plan price result not found.定价计划价格结果没有找到。
400Order.NoRealNameAuthenticationYou have not passed the real-name authentication and do not meet the purchase conditions. Please log in to the user center for real-name authentication.您还未通过实名认证,不符合购买条件,请登录用户中心进行实名认证。

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

变更历史

变更时间变更内容概要操作
2023-05-24OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
出参OpenAPI 返回结构发生变更