文档首页/ 云数据库 RDS/ API参考/ API v3.1（推荐）/ 查询慢日志统计信息
更新时间：2024-03-12 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，表示从第一条数据开始查询。

limit

否

Integer

每页多少条记录（查询结果），取值范围是1~100，不填时默认为10。

type

否

String

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

枚举值：

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

database

否

String

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

sort

否

String

指定排序字段。

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

order

否

String

排序顺序。默认desc。

枚举值：

  • desc
  • asc

请求示例

查询慢日志的统计数据，每页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（推荐）

相关文档