Querying the Slow Log
Function
This API is used to query slow logs.
Calling Method
For details, see Calling APIs.
URI
GET /v2/{project_id}/instances/{instance_id}/slowlog
Parameter | Mandatory | Type | Description |
|---|---|---|---|
project_id | Yes | String | Parameter description: Project ID. For details, see Obtaining a Project ID. Constraints: N/A. Value range: N/A. Default value: N/A. |
instance_id | Yes | String | Parameter description: Instance ID. It can be viewed on the instance details page on the DCS console. Constraints: N/A. Value range: N/A. Default value: N/A. |
Parameter | Mandatory | Type | Description |
|---|---|---|---|
offset | No | Integer | Parameter description: Offset, which is the position where the query starts. Constraints: N/A. Value range: ≥ 0 Default value: 0 |
limit | No | Integer | Parameter description: Number of records displayed on each page. Constraints: N/A. Value range: 1–1,000 Default value: 10 |
sort_key | No | String | Parameter description: Keyword based on which the returned results are sorted. Constraints: N/A. Value range:
Default value: start_time |
sort_dir | No | String | Parameter description: Result sorting order. Constraints: N/A. Value range:
Default value: desc |
start_time | Yes | String | Parameter description: Query start time (UTC). Example: 1598803200000. Constraints: N/A. Value range: N/A. Default value: N/A. |
end_time | Yes | String | Parameter description: Query end time (UTC). Example: 1599494399000. Constraints: N/A. Value range: N/A. Default value: N/A. |
Request Parameters
None
Response Parameters
Status code: 200
Parameter | Type | Description |
|---|---|---|
total_num | Integer | Parameter description: Total number of slow logs. Value range: N/A. |
count | Integer | Parameter description: Total number of slow logs. Value range: N/A. |
slowlogs | Array of SlowlogItem objects | Parameter description: Slow log list. Value range: N/A. |
Parameter | Type | Description |
|---|---|---|
id | Integer | Parameter description: Unique ID of a slow log. Value range: N/A. |
command | String | Parameter description: Slow command. Value range: N/A. |
start_time | String | Parameter description: Execution start time. Example: 2020-06-19T07:06:07Z. Value range: N/A. |
duration | String | Parameter description: Duration, in ms. Value range: N/A. |
shard_name | String | Parameter description: Name of the shard where the slow command is executed. This parameter is supported only when the instance type is cluster. Value range: N/A. |
database_id | Integer | Parameter description: Database ID, which is available only to some customers. Value range: 0-255 |
username | String | Parameter description: Account name that can operate on slow logs. This parameter is available only to some customers. Value range: N/A. |
node_role | String | Parameter description: Node type. Value range: N/A |
client_ip | String | Parameter description: Client IP address. Value range: N/A |
Status code: 400
Parameter | Type | Description |
|---|---|---|
error_msg | String | Parameter description: Error message. Value range: N/A. |
error_code | String | Parameter description: Error code. Value range: For details, see Error Codes. |
error_ext_msg | String | Parameter description: Extended error information. This parameter is not used currently and is set to null. Value range: N/A. |
Status code: 401
Parameter | Type | Description |
|---|---|---|
error_msg | String | Parameter description: Error message. Value range: N/A. |
error_code | String | Parameter description: Error code. Value range: For details, see Error Codes. |
error_ext_msg | String | Parameter description: Extended error information. This parameter is not used currently and is set to null. Value range: N/A. |
Status code: 403
Parameter | Type | Description |
|---|---|---|
error_msg | String | Parameter description: Error message. Value range: N/A. |
error_code | String | Parameter description: Error code. Value range: For details, see Error Codes. |
error_ext_msg | String | Parameter description: Extended error information. This parameter is not used currently and is set to null. Value range: N/A. |
Status code: 404
Parameter | Type | Description |
|---|---|---|
error_msg | String | Parameter description: Error message. Value range: N/A. |
error_code | String | Parameter description: Error code. Value range: For details, see Error Codes. |
error_ext_msg | String | Parameter description: Extended error information. This parameter is not used currently and is set to null. Value range: N/A. |
Status code: 500
Parameter | Type | Description |
|---|---|---|
error_msg | String | Parameter description: Error message. Value range: N/A. |
error_code | String | Parameter description: Error code. Value range: For details, see Error Codes. |
error_ext_msg | String | Parameter description: Extended error information. This parameter is not used currently and is set to null. Value range: N/A. |
Example Requests
GET https://{dcs_endpoint}/v2/a4d31cb6-3d72-4fdc-8ec9-6e3a41e47f71/instances/5560df16-cebf-4473-95c4-d1b573c16e79/slowlog?start_time=1598803200000&end_time=1599494399000 Example Responses
Status code: 200
Slow logs queried successfully.
{
"total_num" : 1,
"count" : 1,
"slowlogs" : [ {
"id" : 1,
"start_time" : "2020-06-19T07:06:07Z",
"command" : "SLOWLOG GET 128",
"duration" : "17",
"shard_name" : "group-0",
"database_id" : 1,
"username" : "default",
"node_role" : "master",
"client_ip" : "127.0.0.1:6379"
} ]
} Status code: 400
Invalid request.
{
"error_code" : "DCS.4800",
"error_msg" : "Invalid start_time in the request."
} Status Codes
Status Code | Description |
|---|---|
200 | Slow logs queried successfully. |
400 | Invalid request. |
401 | Invalid authentication information. |
403 | The request is rejected. |
404 | The requested resource is not found. |
500 | Internal service error. |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.

