# 查询数据库慢日志
#### 功能介绍
查询数据库慢日志。
![](https://support.huaweicloud.com/api-taurusdb/public_sys-resources/notice_3.0-zh-cn.png)
**当前页面API为历史版本API，未来可能停止维护。建议及时切换到新接口[获取慢日志详情列表](https://support.huaweicloud.com/api-taurusdb/ListLtsSlowlogDetails.html)。**
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-taurusdb/taurusdb_03_0000.html)。
#### URI
GET /mysql/v3/{project_id}/instances/{instance_id}/slowlog
表1路径参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                                                             |
|:---|:---|:---|:---|
| project_id  | 是    | String | 租户在某一Region下的project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-taurusdb/taurusdb_10_0004.html)。 |
| instance_id | 是    | String | 实例ID                                                                                                                                           |
   
表2Query参数 
| 参数         | 是否必选 | 参数类型    | 描述                                                                     |
|:---|:---|:---|:---|
| start_date | 是    | String  | 开始时间，格式为"yyyy-mm-ddThh:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 |
| end_date   | 是    | String  | 结束时间，格式为"yyyy-mm-ddThh:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。 |
| offset     | 否    | Integer | 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数  |
| limit      | 否    | Integer | 查询记录数。默认为100，不能为负数，最小值为1，最大值为100                                       |
| type       | 否    | String  | 语句类型，取空值，表示查询所有语句类型，也可指定如下日志类型：INSERT、UPDATE、SELECT、DELETE和CREATE      |
| node_id    | 是    | String  | 节点ID                                                                   |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| x-auth-token | 是    | String | 用户Token。 通过调用IAM服务[获取用户Token](https://support.huaweicloud.com/api-iam/iam_30_0001.html)接口获取。 请求响应成功后在响应消息头中包含的"X-Subject-Token"的值即为Token值。                                           |
| X-Language   | 否    | String | 请求语言类型。默认en-us。 取值范围： - en-us  - zh-cn   |
   
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数              | 参数类型                                                                              | 描述        |
|:---|:---|:---|
| slow_log_list   | Array of [MysqlSlowLogList] objects | 错误日志具体信息。 |
| long_query_time | String                                                                            | 慢日志阈值。    |
| total_record    | Integer                                                                           | 总记录数。     |
   
 表5MysqlSlowLogList 
| 参数            | 参数类型   | 描述         |
|:---|:---|:---|
| node_id       | String | 节点ID。      |
| 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地址。      |
   
**状态码： 400**
表6响应Body参数 
| 参数         | 参数类型   | 描述    |
|:---|:---|:---|
| error_code | String | 错误码。  |
| error_msg  | String | 错误消息。 |
   
**状态码： 500**
表7响应Body参数 
| 参数         | 参数类型   | 描述    |
|:---|:---|:---|
| error_code | String | 错误码。  |
| error_msg  | String | 错误消息。 |
   
#### 请求示例
```
GET https://{endpoint}/mysql/v3/054e292c9880d4992f02c0196d3ea468/instances/3d39c18788b54a919bab633874c159dfin01/slowlog
```
#### 响应示例
**状态码： 200**
Success.
- 示例 1
  ```
  {
    "error_log_list" : [ {
      "node_id" : "cc07c60e94ec4575989840e648fb4f66no07",
      "count" : 1,
      "time" : "1.04899 s",
      "lock_time" : "0.00003 s",
      "rows_sent" : 0,
      "rows_examined" : 0,
      "database" : "gaussdb-mysql",
      "users" : "root",
      "query_sample" : "INSERT INTO time_zone_name (Name, Time_zone_id) VALUES (N @time_zone_id);",
      "type" : "INSERT",
      "start_time" : "2121-03-25T10:55:16",
      "client_ip" : "192.*.*.1"
    } ]
  }
  ```
  
- 示例 2
  ```
  10
  ```
  
- 示例 3
  ```
  15
  ```
  
 
#### 状态码
| 状态码 | 描述            |
|:---|:---|
| 200 | Success.      |
| 400 | Client error. |
| 500 | Server error. |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-taurusdb/ErrorCode.html)。