查询慢日志统计信息 - ShowSlowLogStatistics
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
URI
POST /v3/{project_id}/instances/{instance_id}/slow-logs/statistics
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 租户在某一Region下的project ID。 获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,且长度为32个字符。 默认取值: 不涉及。 |
|
instance_id |
是 |
String |
参数解释: 实例ID,此参数是实例的唯一标识。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,后缀为in07,长度为36个字符。 默认取值: 不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
X-Language |
否 |
String |
参数解释: 请求语言类型。 约束限制: 不涉及。 取值范围: 默认取值: en-us。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
limit |
否 |
Integer |
参数解释: 查询记录数。 约束限制: 必须为整数,不能为负数。 取值范围: 1-100。 默认取值: 100。 |
|
offset |
否 |
Integer |
参数解释: 索引位置,偏移量。从第一条数据偏移offset条数据后开始查询。 约束限制: 必须为整数,不能为负数。 取值范围: ≥0。 默认取值: 0。 |
|
node_id |
是 |
String |
参数解释: 节点ID。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字组成,前面为UUID,后缀为no07,长度为36个字符。 默认取值: 不涉及。 |
|
type |
否 |
String |
参数解释: 语句类型,取空值,表示查询所有语句类型。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
|
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 |
参数解释: 指定排序字段。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
|
order |
否 |
String |
参数解释: 排序顺序。 约束限制: 不涉及。 取值范围: 默认取值: desc。 |
响应参数
状态码: 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
slow_log_list |
Array of ShowSlowLogStatisticsItem objects |
参数解释: 慢日志统计信息列表。 |
|
total_count |
Integer |
参数解释: 总条数。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码。 |
|
error_msg |
String |
错误消息。 |
状态码: 500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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
}
状态码
请参见状态码。
错误码
请参见错误码。