# 慢日志监控
#### 功能介绍
查询指定时间段内在DDM实例上执行过的慢sql相关信息。
#### 接口约束
无
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=DDM&api=ListSlowLog)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### URI
GET /v2/{project_id}/instances/{instance_id}/slowlog?curPage={curPage}\&perPage={perPage}\&startDate={startDate}\&endDate={endDate}
表1路径参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                                   |
|:---|:---|:---|:---|
| project_id  | 是    | String | 项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ddm/ddm_api_01_0063.html)。 |
| instance_id | 是    | String | DDM实例ID。                                                                                                             |
   
表2Query参数 
| 参数        | 是否必选 | 参数类型   | 描述                                                                        |
|:---|:---|:---|:---|
| curPage   | 是    | String | 分页参数：起始值 \[大于等于1\] 。                                                      |
| perPage   | 是    | String | 分页参数：每页多少条。                                                               |
| startDate | 是    | String | 开始时间，UNIX时间戳格式，单位是毫秒。                                                     |
| endDate   | 是    | String | 结束时间，UNIX时间戳格式，单位是毫秒。 结束时间与开始时间，间隔不能超过7天。 |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                    |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 通过调用IAM服务的"获取用户Token"接口来获取。 |
   
#### 响应参数
**状态码： 200**
表4响应Body参数 
| 参数          | 参数类型                                                                   | 描述                |
|:---|:---|:---|
| totalRecord | Integer                                                                | DDM慢SQL日志条数。      |
| slowLogList | Array of [SlowLogList] objects | DDM慢SQL日志信息列表的集合。 |
   
 表5SlowLogList 
| 参数           | 参数类型   | 描述                                            |
|:---|:---|:---|
| users        | String | 执行慢SQL的DDM账号名称。                               |
| database     | String | 慢SQL所属逻辑库的名称。                                 |
| querySample  | String | 慢SQL执行语法。                                     |
| logTime      | String | DDM慢SQL开始执行时间，格式为"yyyy-mm-ddThh:mm:ssZ"。      |
| time         | String | 慢SQL的执行时长，精确到毫秒。                              |
| shards       | String | 逻辑库物理分片名称。                                    |
| rowsExamined | String | 慢SQL影响行数。                                     |
| host         | String | 客户端IP，该IP地址可能涉及个人数据，建议用户依据实际IP地址的敏感性做查询后脱敏处理。 |
   
**状态码： 400**
表6响应Body参数 
| 参数              | 参数类型   | 描述     |
|:---|:---|:---|
| errCode         | String | 业务错误码。 |
| externalMessage | String | 错误信息。  |
   
**状态码： 500**
表7响应Body参数 
| 参数              | 参数类型   | 描述     |
|:---|:---|:---|
| errCode         | String | 业务错误码。 |
| externalMessage | String | 错误信息。  |
   
#### 请求示例
查询指定时间段内在DDM实例上执行过的慢日志。
```
GET https://{endpoint}/v2/{project_id}/instances/{instance_id}/slowlog?curPage={curPage}&perPage={perPage}&startDate={startDate}&endDate={endDate}
```
#### 响应示例
**状态码： 200**
OK
```
{
  "totalRecord" : 2,
  "slowLogList" : [ {
    "users" : "testddm",
    "database" : "test1",
    "querySample" : "select id, sleep(3) from test",
    "logTime" : "2021-04-26T02:40:21",
    "time" : "12002",
    "shards" : "test1_0000",
    "rowsExamined" : "4",
    "host" : "192.168.16.18"
  } ]
}
```
**状态码： 400**
bad request
```
{
  "externalMessage" : "Parameter error.",
  "errCode" : "DBS.280001"
}
```
**状态码： 500**
server error
```
{
  "externalMessage" : "Server failure.",
  "errCode" : "DBS.200412"
}
```
#### 状态码
| 状态码 | 描述           |
|:---|:---|
| 200 | OK           |
| 400 | bad request  |
| 500 | server error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ddm/ddm_api_01_0061.html)。