You need to enable JavaScript to run this app.
导航

DescribeSlowLogs

最近更新时间2024.04.26 11:07:55

首次发布时间2024.04.26 11:07:55

调用 DescribeSlowLogs 接口查询指定实例在指定时间内的慢日志列表。

请求类型

同步请求。

注意事项

当前仅支持查看最近 7 天内的慢日志详情。

请求参数

参数类型是否必选示例值描述

InstanceId

String

mongo-replica-46cb08bc****

实例 ID。

说明

您可以调用 DescribeDBInstances 接口查询目标地域下所有 MongoDB 实例的基本信息,包括实例 ID。

LimitLong10每页记录数,取值范围为 1~1000。
StartTimeLong1712728800查询开始时间,格式为 Unix 时间戳,单位:秒。

EndTime

Long

1712728860

查询结束时间,格式为 Unix 时间戳,单位:秒。

说明

查询结束时间需晚于查询开始时间。

PodName

String

mongo-replica-46cb08bc****-1

需要查询慢日志信息的节点 ID。

说明

您可以调用 DescribeDBInstanceDetail 接口获取指定实例的详细信息,包括实例中各节点的节点 ID 。其中:

  • 副本集实例中的 NodeId 即为 PodName
  • 分片集实例中:
    • ConfigServersId 即为 ConfigServer 节点的 PodName
    • MongosNodeId 即为 Mongos 节点的 PodName
    • NodeId 即为 Shard 节点的 PodName

Sort

String

ASC

将查询结果按照日志生成时间升序或降序排列。取值范围如下:

  • DESC(默认):降序排列。
  • ASC:升序排列。

Context

String

[1712731868000000,3559571755,2097165,null]

慢日志记录查询结果的上下文,需要加载更多慢日志记录时使用。

说明

调用 DescribeSlowLogs 接口后,您可以根据返回参数 ListOver 的值来确定是否还有未加载的慢日志记录:

  • 若 ListOver 的值为 false,表示还有符合查询条件的慢日志记录未加载完,您可以再次调用 DescribeSlowLogs 接口,并使用上一次接口调用时返回参数中的 Context 值来查看剩余的慢日志记录。
  • 若 ListOver 的值为 true,表示已加载完全部符合查询条件的慢日志记录。

返回参数

参数类型示例值描述
TotalInteger1查询结果总条目数。
DatasArray of SlowLog请参见返回示例。符合查询条件的慢日志列表详情。
ContextString[1712731868000000,3559571755,2097165,null]慢日志记录查询结果的上下文,需要加载更多慢日志记录时使用。

ListOver

Boolean

true

慢日志日志内容是否已全部加载。取值范围如下:

  • true:已全部加载。
  • false:未全部加载。

说明

若 ListOver 返回 false,您可以再次调用 DescribeSlowLogs,并在请求参数中传入 Context 返回的值,来查询未加载完的慢日志详情。

SlowLog

参数类型示例值描述
SQLString请参见返回示例。慢查询语句。
DBNameStringtest528683数据库名称。
ReturnLong2返回行数。
ClientIPString127.0.0.1发出慢查询请求的客户端地址。
DurationLong108慢查询语句执行时长,单位:毫秒(ms)。
FileScanLong10文档扫描行数。
UserNameStringroot@admin账号名称。
IndexScanLong5索引扫描行数。
StartTimeString2024-04-10T14:00:03.875当前慢日志的执行开始时间,格式为 yyyy-MM-ddTHH:mm:ss.SSS(UTC)。

示例

请求示例

POST https://mongodb.volcengineapi.com/?Action=DescribeSlowLogs&Version=2022-01-01 HTTP/1.1
Host: mongodb.volcengineapi.com
Content-Type: application/json; charset=utf-8
X-Date: 20201103T104027Z
Authorization: HMAC-SHA256 Credential=AK****/20201103/cn-beijing/mongodb/request,SignedHeaders=content-type;host;x-date,Signature=****
{
    "Limit": 10,
    "StartTime": 1712728800,
    "EndTime": 1712728860,
    "Sort": "ASC",
    "InstanceId": "mongo-replica-e405f8e2****",
    "PodName": "mongo-replica-46cb08bc****-1",
    "Context": "[1712731868000000,3559571755,2097165,null]"
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202306041104200100100232280022D31",
        "Action": "DescribeSlowLogs",
        "Version": "2022-01-01",
        "Service": "mongodb",
        "Region": "cn-beijing"
    },
    "Result": {
        "Total": 1,
        "Datas": [
            {
                "DBName": "test528683",
                "UserName": "root@admin",
                "SQL": "{ \t\"op\": \"select\", \t\"ns\": \"test528683.test528683\", \t\"command\": { **** \t}, \t\"user\": \"root@admin\" }",
                "StartTime": "2024-04-10T14:00:03.875",
                "Duration": 108,
                "ClientIP": "127.0.0.1",
                "FileScan": 10,
                "Return": 2,
                "IndexScan": 5
            }
        ],
        "Context": "[1712731868000000,3559571755,2097165,null]",
        "ListOver": true
    }
}