DescribeSlowLogStatistic - 慢日志统计信息_数据库自治服务(DAS)-阿里云帮助中心

慢日志统计信息。

接口说明

请确保在使用该接口前，已充分了解 DAS 产品的收费方式和价格。

使用该接口需满足以下前提条件：

请求实例已开通智能运维服务。
使用阿里云或 DAS 的 SDK 时，建议使用最新版本。
在使用 SDK 调用 DAS 服务时，需要将地域指定为 cn-shanghai。

该接口异步调用后不会立即返回完整结果，当返回数据中 isFinish 取值为 false 时，请等待 1s 后重新发起调用，直到 isFinish 取值为 true 时，返回完整结果。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

hdm:DescribeSlowLogStatistic

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
InstanceId	string	是	实例 ID。	rm-2ze1jdv45i7l6****
NodeId	string	否	节点 ID。对于 RDS MySQL 和 PolarDB MySQL 版，该参数仅适用于集群版实例。若不传该参数，默认查询主节点日志明细。对于 PolarDB-X 2.0，该参数传入polarx_cn（计算节点）或polarx_dn（数据节点）。	r-x****-db-0
Type	string	否	任务类型： SlowLogRequestOrigin：groupBy originHost，通过来源 IP 聚合模板。 OriginHost：OriginHost groupBy SQLID，通过 SQLID 聚合模板，并且限制 originHost 为 templateID。 SlowLogRequestUser：groupBy user，通过来源 USER 聚合模板。 SQL：SQL groupBy SQLID，通过 SQLID 聚合模板，并且限制 SQLID 为 templateID。	SQL
TemplateId	string	否	模板 ID。	04ea3310df40c3fa8a6b4854db49f79a
StartTime	integer	是	查询任务开始时间，格式为 Unix 时间戳（UTC 时间），单位为毫秒。	1568269711000
EndTime	integer	是	查询结束时间，格式为 Unix 时间戳（UTC 时间），单位为毫秒。	1608888296000
OrderBy	string	否	排序方式，可选为： Count QueryTime LockTime RowsExamined RowsSent	count
Asc	boolean	否	升序排序开关，默认关闭。	true
PageNumber	integer	否	查询列表的页码，起始值为 1，默认值为 1。	1
PageSize	integer	否	每页最大记录数，默认值为 10。	20
Filters	array	否	查询筛选条件列表。
	object	否	Key 支持的参数和取值： hostAddress：来源，多个逗号分隔。 sqlId：sqlId，多个逗号分隔。 user：用户，多个逗号分隔。 dbName：数据库，多个逗号分隔。 keyWord：关键字，多个空格分隔。 tags：标签,多个逗号分隔。
Key	string	否	过滤参数	KeyWords
Value	string	否	过滤参数的值。	select

返回参数

名称	类型	描述	示例值
	object
Code	string	返回的状态码。	200
Message	string	请求返回消息。说明请求成功时该参数返回 Successful，请求失败时会返回请求异常信息（如错误码等）。	Successful
RequestId	string	请求 ID。	52D540CF-C517-1F57-BB42-9035F96******
Success	string	请求是否执行成功： true：执行成功。 false：执行失败。	true
Data	object	AsyncResult<DBLogRecords>
RequestKey	string	请求参数的 Key。	123456789
ResultId	string	结果 ID。	async__665ee69612f1627c7fd9f3c85075****
State	string	当前状态： -RUNNING：正在运行。 -SUCCESS：成功。 -FAIL：失败。	SUCCESS
IsFinish	boolean	是否完成。	true
Data	object	数据。
DbInstanceName	string	实例 ID。	0
NodeId	string	节点 ID。对于 MongoDB 实例，通过该参数指定节点进行空间分析。调用 DescribeRoleZoneInfo 接口，可以查询 MongoDB 实例各个节点的详细信息。当传入目标节点的 InsName（节点 ID）时，例如`d-bp1872fa24d5**`，调用该接口分析其对应的 Hidden 节点。当传入目标节点的`InsName#RoleId`时，例如`d-bp1872fa24d5#299**5`，调用该接口分析指定的节点。重要对于 MongoDB 副本集实例，不传入此参数时，调用该接口会默认分析唯一的 Hidden 节点。对于 MongoDB 分片集群实例，推荐传入此参数，指定目标节点。	pi-wz99g5rn7w1x8h0sf
ItemsNumbers	integer	当前页查询日志列表内的 Item 数量。	10
StartTime	string	开始时间，格式为 Unix 时间戳，单位为毫秒。	2024-10-08T02:01:00Z
EndTime	string	查询任务结束时间，格式为 Unix 时间戳，单位为毫秒。说明查询任务结束时间需晚于查询任务开始时间。	2024-08-08T02:15:00Z
DbInstanceId	integer	实例数字 ID。	rm-k2ja51w7cnusg5a1x
TotalRecords	integer	总记录数。	13
PageNumbers	integer	分页查询的页码，从 1 开始，默认为 1。	1
MaxRecordsPerPage	integer	分页查询每页最大记录数。取值范围：5～100。	10
Logs	array	操作对象名称。
	object	日志。
Count	integer	Key 的元素个数。	12
MaxLockTime	number	已废弃。	-
MaxQueryTime	number	已废弃。	-
MaxRowsExamined	integer	最大扫描行数。	318613
MaxRowsSent	integer	最大返回行数。	256
AvgQueryTime	number	已废弃。	-
QueryTimeRate	number	查询耗时比例。	0.1018
CountRate	number	执行次数比例。	0.2034
AvgRowsExamined	number	平均扫描行数。	53421.0
OriginAlias	string	来源别名。	order-1
User	string	用户。	user-1
SqlTag	object	标签。
SqlId	string	SQL ID。	a3931d8c3a9315dd5ed016d71cf*****
Tags	string	逗号分隔的多个 tag。	DAS_IN_PLAN
Comments	string	备注。长度为 1~300 个字符。	dba 归档
Trend	array	慢日志趋势。
	object	慢日志趋势。
Timestamp	integer	执行时间，格式为 Unix 时间戳，单位为毫秒（ms）。	1723775362
Value	any	过滤参数的值。	tf-testacc-oos-parameter
Database	string	数据库名。	work-wechat-api
Histogram	object	趋势图数据。
Total	integer	查询的总记录数。	7
Count	array	慢日志数量。
	integer	慢日志数量。	100
Ts	array	执行时间戳。
	integer	事件发生的时间，使用 UNIX 时间戳表示，单位：秒。	1715220818
TsEnd	array	已废弃。
	integer	已废弃。	-
Item	array	任务状态。
	object	错误码信息。
NodeId	string	节点 id。	r-bp1s1m8hwzrm77kfvz-db-0
Count	array	慢日志数量。
	integer	Key 的元素个数。	100
Rt	array	执行耗时，单位为秒。
	number	执行耗时，单位为秒。	1854
AvgRt	array	平均执行耗时。
	number	平均执行耗时。	3709
MaxRt	array	最大 RT，单位 ms。
	number	最大 RT，单位 ms。	2516.0
LockTime	array	锁等待时间，单位毫秒。
	number	锁等待时间，单位毫秒。	300
AvgLockTime	array	平均锁等待时间，单位为秒。
	number	平均锁等待时间，单位为秒。	15
MaxLockTime	array	最大锁等待时间，单位为秒。
	number	最大锁等待时间，单位为秒。	1051
RowsExamined	array	总扫描行数。说明目前支持该字段的数据库：RDS MySQL、RDS PostgreSQL、PolarDB MySQL 版。
	integer	总扫描行数。说明目前支持该字段的数据库：RDS MySQL、RDS PostgreSQL、PolarDB MySQL 版。	641057
AvgRowsExamined	array	平均扫描行数。
	number	平均扫描行数。	222189
MaxRowsExamined	array	最大扫描行数。
	integer	最大扫描行数。	878511
RowsSent	array	返回行数。
	integer	返回行数。	4
AvgRowsSent	array	平均返回行数。
	number	平均返回行数。	2.0
MaxRowsSent	array	最大返回行数。
	integer	最大返回行数。	256
SqlId	string	SQL ID。	2dca88762ec6b3812504ab8a4b******
Scheme	string	HTTP 或 HTTPS。	HTTP
SubInstanceId	string	子实例 ID。	r-8vba51c588ba3a94
DbInstanceName	string	实例 ID。	0
InsName	string	分片名。	rm-uf6zix1z2jh1y6fe5
AccountName	string	数据库账号。	edu_admin
HostAddress	string	客户端 IP 地址。	172.23.142.178
QueryStartTime	string	查询开始的时间。格式：yyyy-MM-dd hh:mm:ss（UTC 时间）。	2024-12-25T03:00:00Z
SQLText	string	SQL 语句详情。	SELECT 'Hello, World!' FROM DUAL
Psql	string	SQL 模板。	SELECT b?.id,b?.t?,b?.id,b?.t? FROM testtb? b? JOIN testtb? b? ON b?.id=b?.id WHERE b?.t? LIKE ? ORDER BY b?.id DESC
DBName	string	数据库名称。	member_score
QueryTime	integer	查询执行时间阈值，单位为毫秒（ms）。	272.444
ReturnItemNumbers	string	返回项目编号。	暂无
DocsExamined	integer	MongoDB 该操作执行时扫描的文档数。	1
KeysExamined	integer	MongoDB 索引扫描行数。	20000
TableName	string	表名。	users\nifconfig\n
LockTime	number	已废弃。	-
RowsExamined	integer	总扫描行数。说明目前支持该字段的数据库：RDS MySQL、RDS PostgreSQL、PolarDB MySQL 版。	2444081
RowsSent	integer	返回行数。	772
ThreadId	string	仅 PolarDB MySQL 有 thread_id。	1
Timestamp	integer	执行时间，格式为 Unix 时间戳，单位为毫秒（ms）。	1708568930
AvgLockTime	number	已废弃。	-
AvgRowsSent	number	平均返回行数。	2.0
LockTimeSeconds	number	锁等待时间，单位为秒。	0.0
QueryTimeSeconds	number	查询耗时，单位为秒。	25.472
AvgLockTimeSeconds	number	平均锁等待时间，单位为秒。	0.0
MaxLockTimeSeconds	number	最大锁等待时间，单位为秒。	0.0
MaxQueryTimeSeconds	number	最大查询耗时，单位为秒。	14.402
AvgQueryTimeSeconds	number	平均查询耗时，单位为秒。	6.211
SqlType	string	SQL 语句的类型。	LOGIN
QueryId	string	Query ID。说明仅云数据库 MongoDB 版实例支持。	sq-1pzcdMwRb
NodeType	string	节点类型。说明目前支持该字段的数据库：云数据库 MongoDB 版、云数据库 Tair（兼容 Redis）。	DLNode
HostInsId	string	主机实例 id。说明仅云数据库 MongoDB 版实例支持。	mongo-abc123456
InsRole	string	实例角色。说明仅云数据库 MongoDB 版实例支持。	__system
OpType	string	操作类型。说明仅云数据库 MongoDB 版实例支持。	Insert
Namespace	string	命名空间。说明仅云数据库 MongoDB 版实例支持。	database.collection
AvgKeysExamined	number	平均索引扫描行数。说明仅云数据库 MongoDB 版实例支持。	20000
AvgDocExamined	number	平均扫描文档行数。说明仅云数据库 MongoDB 版实例支持。	10000
AvgReturnNum	number	平均返回行数。说明仅云数据库 MongoDB 版实例支持。	1
MaxKeysExamined	integer	最大索引扫描行数。说明仅云数据库 MongoDB 版实例支持。	2000000
MaxDocExamined	integer	最大扫描文档行数。说明仅云数据库 MongoDB 版实例支持。	1000000
MaxReturnNum	integer	最大返回行数。说明仅云数据库 MongoDB 版实例支持。	1
ReturnNum	integer	返回行数。说明仅云数据库 MongoDB 版实例支持。	1
DocExamined	integer	扫描文档行数。说明仅云数据库 MongoDB 版实例支持。	2000000
Command	string	慢查询语句。说明仅云数据库 Tair（兼容 Redis）实例支持。	SELECT b?.id,b?.t?,b?.id,b?.t? FROM testtb? b? JOIN testtb? b? ON b?.id=b?.id WHERE b?.t? LIKE ? ORDER BY b?.t? DESC
IOWrites	integer	I/O 写次数。说明仅云数据库 RDS SQL Server 版实例支持。	1000
MaxIOWrites	integer	最大 I/O 写次数。说明仅云数据库 RDS SQL Server 版实例支持。	1000
LastRowsCountAffected	integer	最后一条语句的影响行数。说明仅云数据库 RDS SQL Server 版实例支持。	1000
MaxLastRowsCountAffected	integer	最大最后一条语句的影响行数。说明仅云数据库 RDS SQL Server 版实例支持。	1000
LogicalIOReads	integer	逻辑读次数。说明仅云数据库 RDS SQL Server 版实例支持。	1000
MaxLogicalIOReads	integer	最大逻辑读次数。说明仅云数据库 RDS SQL Server 版实例支持。	1000
PhysicalIOReads	integer	物理读次数。说明仅云数据库 RDS SQL Server 版实例支持。	1000
MaxPhysicalIOReads	integer	最大物理读次数。说明仅云数据库 RDS SQL Server 版实例支持。	1000
RowsCountAffected	integer	影响的行数。说明仅云数据库 RDS SQL Server 版实例支持。	1000
MaxRowsCountAffected	integer	最大影响的行数。说明仅云数据库 RDS SQL Server 版实例支持。	1000
CPUTime	number	已废弃。	-
AvgCPUTime	number	已废弃。	-
MaxCPUTime	number	已废弃。	-
AvgIOWrites	number	平均 I/O 写次数。说明仅云数据库 RDS SQL Server 版实例支持。	1000
AvgLastRowsCountAffected	number	平均最后一条语句的影响行数。说明仅云数据库 RDS SQL Server 版实例支持。	1000
AvgLogicalIOReads	number	平均逻辑读次数。说明仅云数据库 RDS SQL Server 版实例支持。	1000
AvgPhysicalIOReads	number	平均物理读次数。说明仅云数据库 RDS SQL Server 版实例支持。	1000
AvgRowsCountAffected	number	平均影响的行数。说明仅云数据库 RDS SQL Server 版实例支持。	1000
AvgCPUTimeSeconds	number	CPU 平均查询时间，单位秒。	456
MaxCPUTimeSeconds	number	CPU 最长查询时间，单位秒。	456
CPUTimeSeconds	number	CPU 查询时间，单位秒。说明仅云数据库 RDS SQL Server 版实例支持。	456
Rows	integer	PolarDB-X 2.0 数据库实例计算节点总更新或返回的行数。说明仅云数据库 PolarDB-X 2.0 版实例支持。	105
AvgRows	number	平均行数。	10
MaxRows	integer	最大行数。	10
Frows	integer	PolarDB-X 2.0 计算节点（CN）的拉取行数。说明仅云数据库 PolarDB-X 2.0 版实例支持。	10
AvgFrows	number	平均拉取行数。	10
MaxFrows	integer	最大拉取行数。	10
Scnt	integer	PolarDB-X 2.0 计算节点（CN）的 DN 请求数。说明仅云数据库 PolarDB-X 2.0 版实例支持。	10
AvgScnt	number	平均请求数。	10
MaxScnt	integer	最大请求数。	10
RuleId	string	规则 ID，具体信息请参见查询治理。	181**47
ErrorCode	integer	错误码。	10910
Message	string	错误信息。	Successful
Timestamp	integer	请求时间。	1735104224250

示例

正常返回示例

JSON格式

{
  "Code": "200",
  "Message": "Successful",
  "RequestId": "52D540CF-C517-1F57-BB42-9035F96******",
  "Success": "true",
  "Data": {
    "RequestKey": "123456789",
    "ResultId": "async__665ee69612f1627c7fd9f3c85075****",
    "State": "SUCCESS",
    "IsFinish": true,
    "Data": {
      "DbInstanceName": "0",
      "NodeId": "pi-wz99g5rn7w1x8h0sf",
      "ItemsNumbers": 10,
      "StartTime": "2024-10-08T02:01:00Z",
      "EndTime": "2024-08-08T02:15:00Z",
      "DbInstanceId": 0,
      "TotalRecords": 13,
      "PageNumbers": 1,
      "MaxRecordsPerPage": 10,
      "Logs": [
        {
          "Count": 12,
          "MaxLockTime": 0,
          "MaxQueryTime": 0,
          "MaxRowsExamined": 318613,
          "MaxRowsSent": 256,
          "AvgQueryTime": 0,
          "QueryTimeRate": 0.1018,
          "CountRate": 0.2034,
          "AvgRowsExamined": 53421,
          "OriginAlias": "order-1",
          "User": "user-1",
          "SqlTag": {
            "SqlId": "a3931d8c3a9315dd5ed016d71cf*****",
            "Tags": "DAS_IN_PLAN",
            "Comments": "dba 归档"
          },
          "Trend": [
            {
              "Timestamp": 1723775362,
              "Value": "tf-testacc-oos-parameter"
            }
          ],
          "Database": "work-wechat-api",
          "Histogram": {
            "Total": 7,
            "Count": [
              100
            ],
            "Ts": [
              1715220818
            ],
            "TsEnd": [
              0
            ],
            "Item": [
              {
                "NodeId": "r-bp1s1m8hwzrm77kfvz-db-0",
                "Count": [
                  100
                ]
              }
            ],
            "Rt": [
              1854
            ],
            "AvgRt": [
              3709
            ],
            "MaxRt": [
              2516
            ],
            "LockTime": [
              300
            ],
            "AvgLockTime": [
              15
            ],
            "MaxLockTime": [
              1051
            ],
            "RowsExamined": [
              641057
            ],
            "AvgRowsExamined": [
              222189
            ],
            "MaxRowsExamined": [
              878511
            ],
            "RowsSent": [
              4
            ],
            "AvgRowsSent": [
              2
            ],
            "MaxRowsSent": [
              256
            ]
          },
          "SqlId": "2dca88762ec6b3812504ab8a4b******",
          "Scheme": "HTTP",
          "SubInstanceId": "r-8vba51c588ba3a94",
          "DbInstanceName": "0",
          "InsName": "rm-uf6zix1z2jh1y6fe5",
          "AccountName": "edu_admin",
          "HostAddress": "172.23.142.178",
          "QueryStartTime": "2024-12-25T03:00:00Z",
          "SQLText": "SELECT 'Hello, World!' FROM DUAL",
          "Psql": "SELECT b?.id,b?.t?,b?.id,b?.t? FROM testtb? b? JOIN testtb? b? ON b?.id=b?.id WHERE b?.t? LIKE ? ORDER BY b?.id DESC",
          "DBName": "member_score",
          "QueryTime": 272.444,
          "ReturnItemNumbers": "暂无",
          "DocsExamined": 1,
          "KeysExamined": 20000,
          "TableName": "users\\nifconfig\\n",
          "LockTime": 0,
          "RowsExamined": 2444081,
          "RowsSent": 772,
          "ThreadId": "1",
          "Timestamp": 1708568930,
          "AvgLockTime": 0,
          "AvgRowsSent": 2,
          "LockTimeSeconds": 0,
          "QueryTimeSeconds": 25.472,
          "AvgLockTimeSeconds": 0,
          "MaxLockTimeSeconds": 0,
          "MaxQueryTimeSeconds": 14.402,
          "AvgQueryTimeSeconds": 6.211,
          "SqlType": "LOGIN",
          "QueryId": "sq-1pzcdMwRb",
          "NodeType": "DLNode",
          "HostInsId": "mongo-abc123456",
          "InsRole": "__system",
          "OpType": "Insert",
          "Namespace": "database.collection",
          "AvgKeysExamined": 20000,
          "AvgDocExamined": 10000,
          "AvgReturnNum": 1,
          "MaxKeysExamined": 2000000,
          "MaxDocExamined": 1000000,
          "MaxReturnNum": 1,
          "ReturnNum": 1,
          "DocExamined": 2000000,
          "Command": "SELECT b?.id,b?.t?,b?.id,b?.t? FROM testtb? b? JOIN testtb? b? ON b?.id=b?.id WHERE b?.t? LIKE ? ORDER BY b?.t? DESC",
          "IOWrites": 1000,
          "MaxIOWrites": 1000,
          "LastRowsCountAffected": 1000,
          "MaxLastRowsCountAffected": 1000,
          "LogicalIOReads": 1000,
          "MaxLogicalIOReads": 1000,
          "PhysicalIOReads": 1000,
          "MaxPhysicalIOReads": 1000,
          "RowsCountAffected": 1000,
          "MaxRowsCountAffected": 1000,
          "CPUTime": 0,
          "AvgCPUTime": 0,
          "MaxCPUTime": 0,
          "AvgIOWrites": 1000,
          "AvgLastRowsCountAffected": 1000,
          "AvgLogicalIOReads": 1000,
          "AvgPhysicalIOReads": 1000,
          "AvgRowsCountAffected": 1000,
          "AvgCPUTimeSeconds": 456,
          "MaxCPUTimeSeconds": 456,
          "CPUTimeSeconds": 456,
          "Rows": 105,
          "AvgRows": 10,
          "MaxRows": 10,
          "Frows": 10,
          "AvgFrows": 10,
          "MaxFrows": 10,
          "Scnt": 10,
          "AvgScnt": 10,
          "MaxScnt": 10,
          "RuleId": "181**47"
        }
      ]
    },
    "ErrorCode": 10910,
    "Message": "Successful",
    "Timestamp": 1735104224250
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParams	The request parameters are invalid.	请求参数错误
403	NoPermission	You are not authorized to do this action.	没有权限执行该操作

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。