文档首页/ 文档数据库服务 DDS/ API参考/ API v3（即将下线）/ 查询数据库慢日志
更新时间：2024-04-01 GMT+08:00
查看PDF
分享

查询数据库慢日志

接口说明

查询数据库慢日志信息。

该接口计划于2025-03-31下线，建议及时切换到新接口查询数据库慢日志（新版）。

约束说明

在入参start_date和end_date的时间段内最多查询到2000条数据。

URI

  • URI格式

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

  • URI样例
    • 查询数据库慢日志：

      https://dds.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/6ade8143870047b8999aba8f1891b48ein02/slowlog?start_date=2018-08-06T10:41:14+0800&end_date=2018-08-07T10:41:14+0800

    • 根据指定条件查询数据库慢日志：

      https://dds.ap-southeast-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/6ade8143870047b8999aba8f1891b48ein02/slowlog?type=INSERT&offset=1&limit=20&node_id=a7c84462483642798cf159237343135fno06&start_date=2018-08-06T10:41:14+0800&end_date=2018-08-07T10:41:14+0800

表1 参数说明

名称

类型

是否必选

说明

X-Auth-Token

String

是

从IAM服务获取的用户Token。请参考认证鉴权。

project_id

String

是

租户在某一Region下的项目ID。请参考获取项目ID章节获取项目编号。

instance_id

String

是

实例ID，可以调用“查询实例列表”接口获取。如果未申请实例，可以调用“创建实例”接口创建。

start_date

String

是

开始时间，格式为“yyyy-mm-ddThh:mm:ssZ”。

其中，T指某个时间的开始，Z指时区偏移量。

注意：

开始时间早于当前时间31天。

end_date

String

是

结束时间，格式为“yyyy-mm-ddThh:mm:ssZ”。

其中，T指某个时间的开始；Z指时区偏移量。

只能查询当前时间前一个月内的慢日志。

说明：

结束时间不能晚于当前时间。

node_id

String

否

节点ID，请参考表8的“id”。

取空值，表示查询实例下所有允许查询的节点。

允许查询的节点如下：

集群实例下面的 shard节点。

副本集、单节点实例下面的所有节点。

type

String

否

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

  • INSERT
  • QUERY
  • UPDATE
  • REMOVE
  • GETMORE
  • COMMAND
  • KILLCURSORS

offset

Integer

否

索引位置，偏移量。取值范围为 [0, 1999]。

从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数。

limit

Integer

否

查询记录数。取值范围[1, 100]，默认10 （表示默认返回10条数据）。

说明：

limit 与 offset 的和需要满足小于等于2000的条件。

请求消息

无。

响应消息

  • 参数说明
    表2 参数说明

    名称

    参数类型

    说明

    slow_log_list

    Array of objects

    具体信息。

    详情请参见表3。

    total_record

    Integer

    总记录数。
    表3 slow_log_list字段数据结构说明

    名称

    参数类型

    说明

    node_name

    String

    节点名称。

    query_sample

    String

    执行语法。

    type

    String

    语句类型。

    time

    String

    执行时间。

    lock_time

    String

    等待锁时间。

    rows_sent

    String

    结果行数量。

    rows_examined

    String

    扫描的行数量。

    database

    String

    所属数据库。

    start_time

    String

    发生时间，UTC时间。
  • 响应示例 
    {
  "slow_log_list": [
    {
      "node_name": "Test_replica_node_2",
      "query_sample": "{\"responseLength\": 230, \"ts\": {\"$date\": 1605480486800}, \"ninserted\": 1, \"locks\": {\"oplog\": {\"acquireCount\": {\"w\": 1}}, \"Global\": {\"acquireCount\": {\"r\": 3, \"w\": 2}}, \"Collection\": {\"acquireCount\": {\"w\": 2}}, \"Database\": {\"acquireCount\": {\"w\": 3}}}, \"numYield\": 0, \"ns\": \"geographySpace.tiles\"}",
      "type": "REMOVE",
      "time": "101 ms",
      "lock_time": "10 us",
      "rows_sent": "0",
      "rows_examined": "0",
      "database": "geography",
      "start_time": "2020-11-15T22:49:38.643000Z"
    }
  ],
  "total_record": 1
}

SDK

单击文档数据库服务 DDS SDK，下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。

状态码

详情请参见状态码。

错误码

详情请参见错误码。