查询慢日志
调试
您可以在API Explorer中调试该接口。
接口约束
该接口仅支持MySQL和PostgreSQL数据库引擎。
URI
- 参数说明
表1 参数说明 名称
是否必选
说明
project_id
是
租户在某一Region下的项目ID。
获取方法请参见获取项目ID。
instance_id
是
要查询的实例ID。
请求消息
名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
start_time |
是 |
String |
开始日期,格式为“yyyy-mm-ddThh:mm:ssZ”。 其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。 |
end_time |
是 |
String |
结束时间,格式为“yyyy-mm-ddThh:mm:ssZ”。 其中,T指某个时间的开始;Z指时区偏移量,例如北京时间偏移显示为+0800。只能查询当前时间前一个月内的慢日志。 |
type |
否 |
String |
语句类型,取空值,表示查询所有语句类型。 枚举值:
|
line_num |
否 |
String |
日志单行序列号,第一次查询时不需要此参数,后续分页查询时需要使用,可从上次查询的返回信息中获取。line_num应在start_time和end_time之间。 |
limit |
否 |
Integer |
每页多少条记录(查询结果),取值范围是1~100,不填时默认为10。 |
search_type |
否 |
String |
搜索方式。默认forwards。配合line_num使用,以line_num为起点,向前搜索或向后搜索。 枚举值:
|
database |
否 |
String |
数据库名称。数据库名称不支持包含特殊字符 < > & 等的搜索。 |
请求示例
POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/cee5265e1e5845649e354841234567dfin01/slow-logs { "start_time":"2023-01-02T23:58:57+0000", "end_time":"2023-01-06T01:47:20+0000", "limit":10, "line_num":"1672908793000000000" }
响应消息
- 正常响应要素说明
表3 要素说明 名称
参数类型
说明
slow_log_list
Array of objects
日志数据集合。
详情请参见表4。
long_query_time
String
当前慢日志阈值时间。
表4 slow_log_list字段数据结构说明 名称
参数类型
说明
count
String
执行次数。
time
String
执行时间。
lock_time
String
等待锁时间。仅MySQL支持。
rows_sent
String
结果行数量。仅MySQL支持。
rows_examined
String
扫描的行数量。仅MySQL支持。
database
String
所属数据库。数据库名称如果包含特殊字符 < > ' 等,特殊字符会被转义处理。
users
String
账号。
query_sample
String
执行语法。慢日志默认脱敏显示,如需明文显示,请联系客服人员申请。
type
String
语句类型。
start_time
String
发生时间,UTC时间。
client_ip
String
IP地址。
line_num
String
日志单行序列号。
- 正常响应样例
{ "slow_log_list" : [ { "count" : "1", "time" : "1.04899 s", "lock_time" : "0.00003 s", "rows_sent" : "0", "rows_examined" : "0", "database" : "test_db", "users" : "root", "query_sample" : "INSERT INTO time_zone_name (Name, Time_zone_id) VALUES (N, @time_zone_id);", "type" : "INSERT", "start_time" : "2018-08-06T10:41:14", "client_ip" : "192.*.*.1", "line_num" : "1595659490239433658" } ], "long_query_time" : "1" }
- 异常响应
请参见异常请求结果。
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。