查询数据库慢日志（推荐） - ListSlowLogs
调试
您可以在API Explorer中调试该接口。
授权信息
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
|
授权项 |
访问级别 |
资源类型（*为必须） |
条件键 |
别名 |
依赖的授权项 |
|---|---|---|---|---|---|
|
rds:log:getSlowLogs |
read |
- |
- |
rds:log:list |
- |
接口约束
该接口仅支持MySQL和PostgreSQL数据库引擎。
URI
- URI格式
GET /v3/{project_id}/instances/{instance_id}/slowlog?start_date={start_date}&end_date={end_date}
- 参数说明
表1 参数说明 名称
是否必选
说明
project_id
是
参数解释：
租户在某一region下的project ID。
约束限制：
非空。
取值范围：
获取方法请参见获取项目ID。
默认取值：
不涉及。
instance_id
是
参数解释：
实例ID。
约束限制：
非空。
取值范围：
该参数值可调用查询数据库实例列表接口，通过表4中的“id”获取。
默认取值：
不涉及。
start_date
是
参数解释：
开始日期。
约束限制：
不涉及。
取值范围：
格式为“yyyy-mm-ddThh:mm:ssZ”。
其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。开始时间不能早于当前时间一个月之前。
默认取值：
不涉及。
end_date
是
参数解释：
结束时间。
约束限制：
不涉及。
取值范围：
格式为“yyyy-mm-ddThh:mm:ssZ”。
其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。只能查询当前时间前一个月内的慢日志。
默认取值：
不涉及。
offset
否
参数解释：
页偏移量。
约束限制：
支持查询数据库最近的2000条慢日志信息，参数值须满足offset x limit取值小于等于2000。示例：offset取值为200，limit取值10。
取值范围：
如1、2、3、4等。
默认取值：
不填时默认为1，表示查询当前第一页的数据。
limit
否
参数解释：
每页多少条记录（查询结果）。
约束限制：
不涉及。
取值范围：
取整数1~100。
默认取值：
不填时默认为10。
type
否
参数解释：
语句类型。
约束限制：
不涉及。
取值范围：
取空值，表示查询所有语句类型。
枚举值：
- INSERT
- UPDATE
- SELECT
- DELETE
- CREATE
默认取值：
不涉及。
请求消息
响应消息
- 正常响应要素说明
表2 要素说明 名称
参数类型
说明
slow_log_list
Array of objects
参数解释：
具体信息。
详情请参见表3。
total_record
Integer
参数解释：
总记录数。
取值范围：
不涉及。
表3 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
参数解释：
语句类型。
取值范围：
- INSERT
- UPDATE
- SELECT
- DELETE
- CREATE
start_time
String
参数解释：
发生时间，UTC时间。
取值范围：
不涉及。
client_ip
String
参数解释：
IP地址。
取值范围：
不涉及。
- 正常响应样例
{ "total_record": 1, "slow_log_list": [ { "count": "1", "time": "1.04899 s", "lock_time": "0.00003 s", "rows_sent": "0", "rows_examined": "0", "database": "mysql", "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" } ] } - 异常响应
请参见异常请求结果。
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。
