更新时间:2024-04-01 GMT+08:00

查询数据库慢日志

功能介绍

查询数据库慢日志。

该接口计划于2025-03-31下线,建议及时切换到新接口获取慢日志详情列表

URI

  • URI格式

    GET https://{endpoint}/mysql/v3/{project_id}/instances/{instance_id}/slowlog?offset={offset}&limit={limit}&level={level}&start_date={start_date}&end_date={end_date}&node_id={node_id}

  • URI样例

    GET https://{endpoint}/mysql/v3/97b026aa9cc4417888c14c84a1ad9860/instances/c3ec2c6148ad4d71b1a8411a62df0d3cin07/slowlog?offset=0&limit=100&level=ALL&start_date=2018-08-06T10:41:14+0800&end_date=2018-08-07T10:41:14+0800&node_id=cc07c60e94ec4575989840e648fb4f66no07

    • 参数说明
      表1 参数说明

      名称

      参数类型

      是否必选

      说明

      project_id

      String

      租户在某一Region下的project ID。

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

      instance_id

      String

      实例ID。

      node_id

      String

      实例节点ID。

      start_date

      String

      开始时间,格式为“yyyy-mm-ddThh:mm:ssZ”。

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

      end_date

      String

      结束时间,格式为“yyyy-mm-ddThh:mm:ssZ”。

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

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

      offset

      Integer

      索引位置,偏移量。从第一条数据偏移offset条数据后开始查询,默认为0(偏移0条数据,表示从第一条数据开始查询),必须为数字,最小值为0。

      limit

      Integer

      查询记录数。默认为10,不能为负数,最小值为1,最大值为100。

      type

      String

      语句类型,默认为ALL,取空值,表示查询所有语句类型,也可指定如下日志类型:

      • ALL
      • INSERT
      • UPDATE
      • SELECT
      • DELETE
      • CREATE
      • DROP
      • ALTER

    请求消息

    无。

响应消息

  • 正常响应要素说明
    表2 参数说明

    名称

    参数类型

    说明

    slow _log_list

    Array of objects

    慢日志具体信息。

    详情请参见表3。

    long_query_time

    String

    慢日志阈值,单位:秒。

    total_record

    Integer

    总记录数。

    表3 error_log_list参数说明

    名称

    参数类型

    说明

    node_id

    String

    节点ID。

    time

    String

    执行时间。

    count

    String

    执行次数。

    lock_time

    String

    等待锁时间。

    rows_sent

    String

    结果行数量

    rows_examined

    String

    扫描的行数量

    database

    String

    所属数据库

    users

    String

    账号

    query_sample

    String

    执行语法

    type

    String

    语句类型

    start_time

    String

    发生时间,UTC时间

    client_ip

    String

    IP地址

  • 正常响应样例

    {

    "slow_log_list":[

    {

    "node_id":"cc07c60e94ec4575989840e648fb4f66no07",

    "count":"1",

    "time":"1.04899 s",

    "lock_time":"0.00003 s",

    "rows_sent":"0",

    "rows_examined":"0",

    "database":"gaussdb-mysql",

    "users":"root",

    "query_sample":"INSERT INTO time_zone_name (Name, Time_zone_id) VALUES (N, @time_zone_id);",

    "type":"INSERT",

    "start_time":"2121-03-25T10:55:16",

    "client_ip ":"192.*.*.1"

    }

    ],

    "long_query_time":" 10",

    "total_record":15

    }

状态码

请参见状态码

错误码

请参见错误码