文档首页/ 云数据库 RDS/ API参考/ API v3.1（推荐）/ 查询慢日志统计信息
更新时间：2025-07-16 GMT+08:00
查看PDF
分享

查询慢日志统计信息

功能介绍

查询实例慢日志的统计数据。

调试

您可以在API Explorer中调试该接口。

接口约束

该接口仅支持MySQL和PostgreSQL数据库引擎。

URI

  • URI格式

    POST /v3.1/{project_id}/instances/{instance_id}/slow-logs/statistics

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    是

    参数解释：

    租户在某一Region下的项目ID。

    获取方法请参见获取项目ID。

    约束限制：

    不涉及。

    取值范围：

    不涉及。

    默认取值：

    不涉及。

    instance_id

    是

    参数解释：

    要查询的实例ID。

    约束限制：

    不涉及。

    取值范围：

    不涉及。

    默认取值：

    不涉及。

请求消息

表2 参数说明

名称

是否必选

参数类型

说明

start_time

是

String

参数解释：

开始日期。

约束限制：

不涉及。

取值范围：

格式为“yyyy-mm-ddThh:mm:ssZ”。

其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。

默认取值：

不涉及。

end_time

是

String

参数解释：

结束时间。

约束限制：

只能查询当前时间前一个月内的慢日志。

取值范围：

格式为“yyyy-mm-ddThh:mm:ssZ”。

其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。

默认取值：

不涉及。

offset

否

Integer

参数解释：

索引位置，偏移量。

约束限制：

不涉及。

取值范围：

大于等于0的整数。

默认取值：

默认为0，表示从第一条数据开始查询。

limit

否

Integer

参数解释：

每页多少条记录（查询结果）。

约束限制：

不涉及。

取值范围：

1~100的整数。

默认取值：

不填时默认为10。

type

否

String

参数解释：

SQL语句类型。

约束限制：

不涉及。

取值范围：

取空值，表示查询所有语句类型。

枚举值：

  • INSERT
  • UPDATE
  • SELECT
  • DELETE
  • CREATE
  • ALL

默认取值：

不涉及。

database

否

String

参数解释：

数据库名称。

约束限制：

不涉及。

取值范围：

数据库名称不支持包含特殊字符 < > & 等的搜索。

默认取值：

不涉及。

sort

否

String

参数解释：

指定排序字段。

约束限制：

不涉及。

取值范围：

  • executeTime：表示按照平均执行时间降序排序。
  • 字段为空或传入其他值，表示按照执行次数降序排序。

默认取值：

不涉及。

order

否

String

参数解释：

排序顺序。

约束限制：

不涉及。

取值范围：

枚举值：

  • desc
  • asc

默认取值：

desc

请求示例

查询慢日志的统计数据，每页10条记录。 
POST https://{endpoint}/v3.1/0483b6b16e954cb88930a360d2c4e663/instances/cee5265e1e5845649e354841234567dfin01/slow-logs/statistics
{
    "start_time":"2023-01-05T08:00:00+0800",
    "end_time":"2023-01-11T20:00:00+0800",
    "limit":10,
    "order":"asc"
}

响应消息

  • 正常响应要素说明
    表3 字段说明

    名称

    参数类型

    说明

    slow_log_list

    Array of objects

    参数解释：

    数据集合。

    请参见表4。

    total_count

    Integer

    参数解释：

    总条数。

    取值范围：

    不涉及。
    表4 slow_log_list字段数据结构说明

    名称

    参数类型

    说明

    count

    String

    参数解释：

    执行次数。

    取值范围：

    不涉及。

    time

    String

    参数解释：

    平均执行时间。

    取值范围：

    不涉及。

    lock_time

    String

    参数解释：

    平均等待锁时间。仅MySQL支持。

    取值范围：

    不涉及。

    rows_sent

    Long

    参数解释：

    平均结果行统计数量。仅MySQL支持。

    取值范围：

    不涉及。

    rows_examined

    Long

    参数解释：

    平均扫描的行数量。仅MySQL支持。

    取值范围：

    不涉及。

    database

    String

    参数解释：

    所属数据库。数据库名称如果包含特殊字符 < > ' 等，特殊字符会被转义处理。

    取值范围：

    不涉及。

    users

    String

    参数解释：

    账号。

    取值范围：

    不涉及。

    query_sample

    String

    参数解释：

    执行语法。

    取值范围：

    不涉及。

    client_ip

    String

    参数解释：

    IP地址。

    取值范围：

    不涉及。

    type

    String

    参数解释：

    语句类型。

    取值范围：

    不涉及。
  • 正常响应样例 
    {
  "slow_log_list" : [ { 
    "count" : "9 (100.00%)", 
    "time" : "3.00018 s", 
    "lock_time" : "0.00000 s", 
    "rows_sent" : 1, 
    "rows_examined" : 0, 
    "database" : "test_db", 
    "users" : "root", 
    "query_sample" : "SELECT sleep(N) LIMIT N, N;", 
    "client_ip" : "100.*.*.247", 
    "type" : "SELECT" 
  } ], 
  "total_count" : 1 
}
  • 异常响应

    请参见异常请求结果。

状态码

错误码

请参见错误码。

父主题： API v3.1（推荐）

相关文档