文档首页/ 云数据库 RDS/ API参考/ 历史API/ API v3/ 查询数据库慢日志
更新时间:2024-12-13 GMT+08:00
分享

查询数据库慢日志

功能介绍

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

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

调试

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

接口约束

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

URI

  • URI格式

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

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    租户在某一Region下的项目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

    页偏移量,如1、2、3、4等,不填时默认为1,表示查询当前第一页的数据。

    支持查询数据库最近的2000条慢日志信息,参数值须满足offset x limit取值小于等于2000。示例:offset取值为200,limit取值10。

    limit

    每页多少条记录,取值范围是1~100,不填时默认为10。

    type

    语句类型,取空值,表示查询所有语句类型,也可指定如下日志类型:

    • INSERT
    • UPDATE
    • SELECT
    • DELETE
    • CREATE

请求消息

  • 请求参数

    无。

  • URI样例

    GET https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/cee5265e1e5845649e354841234567dfin01/slowlog?offset=1&limit=10&start_date=2018-08-06T10:41:14+0800&end_date=2018-08-07T10:41:14+0800&type=INSERT

响应消息

  • 正常响应要素说明
    表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"
            }
        ]
    }
  • 异常响应

    请参见异常请求结果

状态码

错误码

请参见错误码

相关文档