获取慢日志统计信息（MySQL）

功能介绍

您可根据业务需求，查询并统计慢日志信息。

该接口计划于2025-03-31下线，建议及时切换到新接口查询慢日志统计信息。

• 调用接口前，您需要了解API 认证鉴权。

调试

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

接口约束

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

URI

• URI格式

  GET /v3/{project_id}/instances/{instance_id}/slowlog/statistics?cur_page={cur_page}&per_page={per_page}&type={type}&start_date={start_date}&end_date={end_date}&sort={sort}

• 参数说明

  表1 参数说明

  名称	是否必选	说明
  project_id	是	租户在某一Region下的项目ID。 获取方法请参见获取项目ID。
  instance_id	是	要查询的实例ID。
  cur_page	是	页偏移量，即当前页码，如1、2、3、4等。
  per_page	是	每页多少条记录，取值范围是0~100。
  start_date	是	开始日期，格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。
  end_date	是	结束时间，格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。
  type	是	语句类型，取空值，表示查询所有语句类型，也可指定如下日志类型： INSERT UPDATE SELECT DELETE CREATE ALL
  sort	否	指定排序字段。 "executeTime"，表示按照执行时间降序排序。 字段为空或传入其他值，表示按照执行次数降序排序。

请求消息

• 请求参数

  无。

• URI样例

  GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/cee5265e1e5845649e354841234567dfin01/slowlog/statistics?cur_page=1&per_page=2&type=INSERT&start_date=2020-02-06T10:41:14+0800&end_date=2020-02-07T10:41:14+0800&sort=executeTime

响应消息

• 正常响应要素说明

  表2 字段说明

  名称	参数类型	说明
  pageNumber	Integer	当前页码。
  pageRecord	Integer	每页条数。
  slowLogList	List	请参见表3。
  totalRecord	Integer	总条数。
  startTime	Long	开始时间。
  endTime	Long	结束时间。

  表3 slowLogList字段数据结构说明

  名称	参数类型	说明
  count	String	执行次数。
  time	String	执行时间。
  lockTime	String	等待锁时间。
  rowsSent	Long	结果行数量。
  rowsExamined	Long	扫描的行数量。
  database	String	所属数据库。
  users	String	账号。
  querySample	String	执行语法。
  type	String	语句类型。
  clientIP	String	IP地址。

• 正常响应样例

  {
  	"pageNumber": 1,
  	"pageRecord": 10,
  	"slowLogList": [],
  	"totalRecord": 0,
          "startTime": null,
          "endTime":null
  }

• 异常响应

  请参见异常请求结果。

状态码

• 正常

  200

• 异常

  请参见状态码。

错误码

请参见错误码。