功能介绍

查询数据库最近的慢日志信息，最多查询2000条。

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

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

调试

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

接口约束

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

URI

URI格式

GET /v3.1/{project_id}/instances/{instance_id}/slowlog?start_date={start_date}&end_date={end_date}

参数说明

表1 参数说明

名称	是否必选	说明
project_id	是	租户在某一region下的project ID。 获取方法请参见获取项目ID。
instance_id	是	要查询的实例ID。
start_date	是	开始日期，格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。
end_date	是	结束时间，格式为“yyyy-mm-ddThh:mm:ssZ”。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。只能查询当前时间前一个月内的慢日志。
offset	否	索引位置，偏移量。 从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。 支持最多查询数据库最近的2000条慢日志信息，参数值须满足offset + limit取值小于等于2000。示例：offset取值为1900，limit取值100。
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	等待锁时间。
rows_sent	String	结果行数量。
rows_examined	String	扫描的行数量。
database	String	所属数据库。
users	String	账号。
query_sample	String	执行语法。慢日志默认脱敏显示，如需明文显示，请联系客服人员添加白名单。
type	String	语句类型。
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"
        }
    ]
}

异常响应

请参见异常请求结果。

状态码

正常

200

异常

请参见状态码。

错误码

请参见错误码。

父主题： API v3.1

同意关联代理商云淘科技，购买华为云产品更优惠（QQ 78315851）

内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家