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

查询数据库慢日志

功能介绍

查询数据库慢日志。

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

URI

GET /v3/{project_id}/instances/{instance_id}/slowlog

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户在某一Region下的project ID。

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

instance_id

String

实例ID

表2 Query参数

参数

是否必选

参数类型

描述

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条数据,表示从第一条数据开始查询),必须为数字,不能为负数

limit

Integer

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

type

String

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

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

node_id

String

节点ID

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token

X-Language

String

语言

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

slow_log_list

Array of MysqlSlowLogList objects

错误日志具体信息。

long_query_time

String

慢日志阈值。

total_record

Integer

总记录数。

表5 MysqlSlowLogList

参数

参数类型

描述

node_id

String

节点ID。

count

String

执行次数。

time

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地址。

状态码: 400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

状态码: 500

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

请求示例

GET https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/096c0fc43e804757b59946b80dc27f8bin07/slowlog?offset=0&limit=1&start_date=2022-07-10T00:00:00+0800&end_date=2022-07-19T00:00:00+0800&node_id=cc07c60e94ec4575989840e648fb4f66no07&type=INSERT

响应示例

状态码: 200

Success.
{
  "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.000Z",
    "client_ip" : "192.*.*.1"
  } ],
  "long_query_time" : 10,
  "total_record" : 15
}

状态码

请参见状态码

错误码

请参见错误码