调用 DescribeAggregateSlowLogs 接口获取慢日志的聚合信息。

请求类型

同步请求。

请求参数

名称	类型	是否必选	示例值	描述
RegionId	string	是	cn-beijing	地域 ID。
InstanceId	string	是	mysql-d39e3357****	实例 ID。说明调用 DescribeDBInstances 接口查询 MySQL 的实例 ID。调用 DescribeDBInstances 接口查询 veDB MySQL 的实例 ID。调用 DescribeDBInstances 接口查询 PostgreSQL 的实例 ID。调用 DescribeDBInstances 接口查询 MongoDB 的实例 ID。
InstanceType	InstanceType	是	MySQL	数据库类型，取值如下： MySQL：表示云数据库 MySQL 版。 VeDBMySQL：表示云数据库 veDB MySQL 版。 Postgres：表示云数据库 PostgreSQL 版。 Mongo：表示文档数据库 MongoDB 版实例。
StartTime	Integer	是	1660536000	查询慢日志的开始时间，使用秒时间戳格式。
EndTime	Integer	是	1660564800	查询慢日志的结束时间，使用秒时间戳格式。说明结束时间要晚于开始时间。
SortBy	String	否	ASC	按照降序或升序方式排列慢日志。取值如下： ASC：表示升序，默认值。 DESC：表示降序。
OrderBy	String	否	TotalQueryTime	返回结果的排序方法，取值如下： TotalQueryTime：按照总耗时排序，默认值。 ExecuteCount：按照执行次数排序。 MaxQueryTime：按照最大执行时间排序。 MaxRowsSent：按照最大返回行数排序。 AverageQueryTime：按照平均执行时间排序。 AverageRowsSent：按照平均返回行数排序。 SQLTemplate：按照 SQL 模板排序。 MaxRowsAffected：按照最大影响行数排序。 AverageRowsAffected：按照平均影响行数排序。 MaxLockTime：按照最大锁等待时间排序。该取值仅适用于数据库 veDB MySQL 版实例。 MaxRowsExamined：按照最大扫描行数排序。该取值仅适用于数据库 veDB MySQL 版实例。 AverageLockTime：按照平均锁等待时间排序。该取值仅适用于数据库 veDB MySQL 版实例。 AverageRowsExamined：按照平均扫描行数排序。该取值仅适用于数据库 veDB MySQL 版实例。 MaxDocsExamined: 按照最大扫描文档数排序，该取值仅适用于文档数据库 MongoDB 版数据库实例。 AverageDocsExamined : 按照平均扫描文档数排序，该取值仅适用于文档数据库 MongoDB 版数据库实例。 MaxKeyExamined: 按照最大扫描索引数排序，该取值仅适用于文档数据库 MongoDB 版数据库实例。 AverageKeyExamined : 按照平均扫描索引数排序，该取值仅适用于文档数据库 MongoDB 版数据库实例。
PageNumber	Integer	否	1	页码。取值范围 1~1000，默认值为 1。
PageSize	Integer	否	10	每页记录数。取值范围 1~1000，默认值为 10。
SearchParam	SearchParamObject	否	{ "GroupIgnored":[ "SourceIP", "User" ], "DBs":[ "test1", "test2" ], "Users":[ "root1", "root2" ], "Keywords":[ "select", "insert" ], "MinQueryTime":30, "MaxQueryTime":30 }	慢日志执行搜索信息。详细信息，请参见 SearchParamObject。
NodeId	string	否	mysql-d39e3357****-01	只读节点 ID。

返回参数

最多支持返回 5000 条慢日志的聚合信息。

参数	类型	示例值	描述
AggregateSlowLogs	Array of AggregateSlowLog	[ { "DB":"mysql", "ExecuteCount":1, "ExecuteCountRatio":33.33, "FirstAppearTime":1702613253, "LastAppearTime":1702613253, "LockTimeRatio":0, "LockTimeStats":{ "Average":0, "Max":0, "Min":0, "Total":0 }, "PTAnalysisResult":"\n# Attribute pct total min max ****", "QueryTimeRatio":22.22, "QueryTimeStats":{ "Average":2.000182, "Max":2.000182, "Min":2.000182, "Total":2.000182 }, "RowsExaminedRatio":0, "RowsExaminedStats":{ "Average":0, "Max":0, "Min":0, "Total":0 }, "RowsSentRatio":33.33, "RowsSentStats":{ "Average":1, "Max":1, "Min":1, "Total":1 }, "SQLTemplate":"select sleep(?)", "SQLTemplateID":"eb4a2b85844fd80206871a75c065411778729031ded219d92281062e8****", "SourceIP":"172.23..**", "User":"test_user" } ]	慢日志聚合信息数组。详细信息，请参见 AggregateSlowLog。
Total	Integer	1	慢日志聚合信息总数。

请求示例

POST https://dbw.cn-beijing.volcengineapi.com/?Action=DescribeAggregateSlowLogs&Version=2018-01-01 HTTP/1.1​
Accept: application/json​
Content-Type: application/json​
Host: dbw.cn-beijing.volcengineapi.com​
X-Date: 20210328T100802Z​
Authorization: HMAC-SHA256 Credential=AKLTYmYwNjAzYjFmMjRkNDQwZWI4MzI1MzhjZGY******/20210328/cn-beijing/dbw/request, SignedHeaders=x-date, Signature=e1d274292f8b36eb096e1d2fec02822bd2e5cb3435699938adb7341*******​
​
{​
    "RegionId":"cn-chongqing-sdv",​
    "InstanceId":"mysql-d39e3357****",​
    "DSType":"MySQL",​
    "StartTime":1702613220,​
    "EndTime":1702613280,​
    "SortBy":"ASC",​
    "PageNumber":1,​
    "PageSize":10,​
    "SearchParam":{​
        "GroupIgnored":[​
            "SourceIP",​
            "User"​
        ],​
        "DBs":[​
            "test1",​
            "test2"​
        ],​
        "Users":[​
            "root1",​
            "root2"​
        ],​
        "Keywords":[​
            "select",​
            "insert"​
        ],​
        "MinQueryTime":20,​
        "MaxQueryTime":30​
    }​
}​

返回示例

{​
    "ResponseMetadata": {​
        "RequestId": "20231215120848C561840BF54F414BD316",​
        "Action": "DescribeAggregateSlowLogs",​
        "Version": "2018-01-01",​
        "Service": "dbw",​
        "Region": "cn-beijing"​
    },​
    "Result": {​
        "AggregateSlowLogs": [​
            {​
                "DB": "mysql",​
                "ExecuteCount": 1,​
                "ExecuteCountRatio": 33.33,​
                "FirstAppearTime": 1702613253,​
                "LastAppearTime": 1702613253,​
                "LockTimeRatio": 0,​
                "LockTimeStats": {​
                    "Average": 0,​
                    "Max": 0,​
                    "Min": 0,​
                    "Total": 0​
                },​
                "PTAnalysisResult": "\n# Attribute     pct   total     min     ******",​
                "QueryTimeRatio": 22.22,​
                "QueryTimeStats": {​
                    "Average": 2.000182,​
                    "Max": 2.000182,​
                    "Min": 2.000182,​
                    "Total": 2.000182​
                },​
                "RowsExaminedRatio": 0,​
                "RowsExaminedStats": {​
                    "Average": 0,​
                    "Max": 0,​
                    "Min": 0,​
                    "Total": 0​
                },​
                "RowsSentRatio": 33.33,​
                "RowsSentStats": {​
                    "Average": 1,​
                    "Max": 1,​
                    "Min": 1,​
                    "Total": 1​
                },​
                "SQLTemplate": "select sleep(?)",​
                "SQLTemplateID": "eb4a2b85844fd80206871a75c065411778729031ded219d92281062e8********",​
                "SourceIP": "172.23.***.***",​
                "User": "test_user"​
            }​
        ],​
        "Total": 1​
    }​
}​

错误码

更多详情，请参见错误码。

数据库工作台