更新时间:2024-03-12 GMT+08:00
分享

查询慢日志

功能介绍

查询实例的慢日志数据。

调试

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

接口约束

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

URI

  • URI格式

    POST /v3/{project_id}/instances/{instance_id}/slow-logs

  • 参数说明
    表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。只能查询当前时间前一个月内的慢日志。

type

String

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

枚举值:

  • INSERT
  • UPDATE
  • SELECT
  • DELETE
  • CREATE

line_num

String

日志单行序列号,第一次查询时不需要此参数,后续分页查询时需要使用,可从上次查询的返回信息中获取。line_num应在start_time和end_time之间。

limit

Integer

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

search_type

String

搜索方式。默认forwards。配合line_num使用,以line_num为起点,向前搜索或向后搜索。

枚举值:

  • forwards
  • backwards

database

String

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

请求示例

查询慢日志数据,每页10条记录。
POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/cee5265e1e5845649e354841234567dfin01/slow-logs
{
    "start_time":"2023-01-02T23:58:57+0000",
    "end_time":"2023-01-06T01:47:20+0000",
    "limit":10,
    "line_num":"1672908793000000000"
}

响应消息

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

    名称

    参数类型

    说明

    slow_log_list

    Array of objects

    日志数据集合。

    详情请参见表4

    long_query_time

    String

    当前慢日志阈值时间。

    表4 slow_log_list字段数据结构说明

    名称

    参数类型

    说明

    count

    String

    执行次数。

    time

    String

    执行时间。

    lock_time

    String

    等待锁时间。仅MySQL支持。

    rows_sent

    String

    结果行数量。仅MySQL支持。

    rows_examined

    String

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

    database

    String

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

    users

    String

    账号。

    query_sample

    String

    执行语法。慢日志默认脱敏显示,如需明文显示,请联系客服人员申请。

    type

    String

    语句类型。

    start_time

    String

    发生时间,UTC时间。

    client_ip

    String

    IP地址。

    line_num

    String

    日志单行序列号。

  • 正常响应样例
    {
      "slow_log_list" : [ { 
        "count" : "1", 
        "time" : "1.04899 s", 
        "lock_time" : "0.00003 s", 
        "rows_sent" : "0", 
        "rows_examined" : "0", 
        "database" : "test_db", 
        "users" : "root", 
        "query_sample" : "INSERT INTO time_zone_name (Name, Time_zone_id) VALUES (N, @time_zone_id);", 
        "type" : "INSERT", 
        "start_time" : "2018-08-06T10:41:14", 
        "client_ip" : "192.*.*.1", 
        "line_num" : "1595659490239433658" 
      } ], 
      "long_query_time" : "1" 
    }
  • 异常响应

    请参见异常请求结果

状态码

错误码

请参见错误码

分享:

    相关文档

    相关产品