
# 查询数据库慢日志
#### 功能介绍
查询数据库慢日志。
![](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 /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指时区偏移量，例如偏移1个小时显示为+0100。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| end_date   | 是    | String  | 结束时间，格式为"yyyy-mm-ddThh:mm:ssZ"。 其中，T指某个时间的开始；Z指时区偏移量，例如偏移1个小时显示为+0100。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| offset     | 否    | Integer | 索引位置，偏移量。从第一条数据偏移offset条数据后开始查询，默认为0（偏移0条数据，表示从第一条数据开始查询），必须为数字，不能为负数                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| limit      | 否    | Integer | 查询记录数。默认为100，不能为负数，最小值为1，最大值为100。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| type       | 否    | String  | 语句类型，取空值，表示查询所有语句类型，也可指定如下日志类型： - INSERT  - UPDATE  - SELECT  - DELETE  - ALTER  - DROP  - 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}/v3/054e292c9880d4992f02c0196d3ea468/instances/096c0fc43e804757b59946b80dc27f8bin07/slowlog?offset=0&limit=1&start_date=2022-07-10T00:00:00+0800&end_date=2022-07-19T00:00:00+0800&node_id=cc07c60e94ec4575989840e648fb4f66no07&type=INSERT
```
#### 响应示例
**状态码： 200**
Success.
```
{
  "slow_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.000Z",
    "client_ip" : "192.*.*.1"
  } ],
  "long_query_time" : 10,
  "total_record" : 15
}
```
#### 状态码
| 状态码 | 描述            |
|:---|:---|
| 200 | Success.      |
| 400 | Client error. |
| 500 | Server error. |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-taurusdb/ErrorCode.html)。
