更新时间:2025-09-04 GMT+08:00

查询慢日志统计信息

功能介绍

查询慢日志统计信息。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

租户在某一Region下的project ID。

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

约束限制

不涉及。

取值范围

只能由英文字母、数字组成,且长度为32个字符。

默认取值

不涉及。

instance_id

String

参数解释

实例ID,此参数是实例的唯一标识。

约束限制

不涉及。

取值范围

只能由英文字母、数字组成,后缀为in07,长度为36个字符。

默认取值

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释

用户Token。 通过调用IAM服务获取用户Token接口获取。

请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

X-Language

String

参数解释

请求语言类型。

约束限制

不涉及。

取值范围

  • en-us

  • zh-cn

默认取值

en-us。

表3 请求Body参数

参数

是否必选

参数类型

描述

limit

Integer

参数解释

查询记录数。

约束限制

必须为整数,不能为负数。

取值范围

1-100。

默认取值

100。

offset

Integer

参数解释

索引位置,偏移量。从第一条数据偏移offset条数据后开始查询。

约束限制

必须为整数,不能为负数。

取值范围

≥0。

默认取值

0。

node_id

String

参数解释

节点ID。

约束限制

不涉及。

取值范围

只能由英文字母、数字组成,前面为UUID,后缀为no07,长度为36个字符。

默认取值

不涉及。

type

String

参数解释

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

约束限制

不涉及。

取值范围:

  • INSERT:插入语句。

  • UPDATE:更新语句。

  • SELECT:查询语句。

  • DELETE:删除语句。

  • CREATE:创建语句。

  • ALL:所有类型。

默认取值

不涉及。

database

String

参数解释

数据库名称。

约束限制

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

取值范围

不涉及。

默认取值

不涉及。

start_time

String

参数解释

开始日期。格式为“yyyy-mm-ddThh:mm:ssZ”。

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

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

end_time

String

参数解释

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

其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。只能查询当前时间前一个月内的慢日志。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

sort

String

参数解释

指定排序字段。

约束限制

不涉及。

取值范围

  • executeTime:表示按照平均执行时间降序排序。

  • 字段为空或传入其他值,表示按照执行次数降序排序。

默认取值

不涉及。

order

String

参数解释

排序顺序。

约束限制

不涉及。

取值范围

  • desc:降序。

  • asc:升序。

默认取值

desc。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

slow_log_list

Array of ShowSlowLogStatisticsItem objects

参数解释

慢日志统计信息列表。

total_count

Integer

参数解释

总条数。

取值范围

不涉及。

表5 ShowSlowLogStatisticsItem

参数

参数类型

描述

client_ip

String

参数解释

IP地址。

默认取值

不涉及。

count

String

参数解释

执行次数。

默认取值

不涉及。

database

String

参数解释

所属数据库。

默认取值

不涉及。

lock_time

String

参数解释

平均等待锁时间。

默认取值

不涉及。

node_id

String

参数解释

节点ID。

默认取值

与入参一致。

query_sample

String

参数解释

执行语法。

默认取值

不涉及。

rows_examined

Integer

参数解释

平均扫描的行数量。

默认取值

不涉及。

rows_sent

Integer

参数解释

平均结果行统计数量。

默认取值

不涉及。

time

String

参数解释

平均执行时间。

默认取值

不涉及。

type

String

参数解释

语句类型。

默认取值

不涉及。

users

String

参数解释

账号。

默认取值

不涉及。

状态码: 400

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

状态码: 500

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误消息。

请求示例

查询慢日志统计信息。

POST https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/6754902da1f447269c6979b0590102a5in07/slow-logs/statistics

{
  "limit" : 10,
  "offset" : 0,
  "node_id" : "4006312b96c541749d735c20e86dd169no07",
  "type" : null,
  "database" : null,
  "start_time" : "2024-08-16T14:37:00+0800",
  "end_time" : "2024-08-16T16:51:22+0800",
  "sort" : null,
  "order" : "desc"
}

响应示例

状态码: 200

Success.

{
  "slow_log_list" : [ {
    "node_id" : "4006312b96c541749d735c20e86dd169no07",
    "count" : "1 (100.00%)",
    "time" : "11.00014 s",
    "lock_time" : "0.00000 s",
    "rows_sent" : 1,
    "rows_examined" : 1,
    "database" : "",
    "users" : "root",
    "query_sample" : "select sleep(N);",
    "client_ip" : "localhost",
    "type" : "SELECT"
  } ],
  "total_count" : 1
}

状态码

请参见状态码

错误码

请参见错误码