DescribeSlowLogHistogramAsync - 异步获取实例慢日志趋势数据

异步获取实例慢日志趋势数据。

接口说明

请确保在使用该接口前,已充分了解 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:DescribeSlowLogHistogramAsync

get

*全部资源

*

请求参数

名称

类型

必填

描述

示例值

InstanceId

string

数据库实例 ID。

rm-2ze8g2am97624****

NodeId

string

节点 ID。

说明

对于 PolarDB MySQL 版实例,需要提供节点 ID。

r-****-db-0

StartTime

integer

查询任务开始时间,格式为 Unix 时间戳,单位为毫秒。

1596177993000

EndTime

integer

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

说明

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

1662518540764

Filters

array

查询筛选条件列表。

object

Key 支持的参数和取值:

hostAddress:来源,多个逗号分隔。

sqlId:sqlId,多个逗号分隔。

user:用户,多个逗号分隔。

dbName:数据库,多个逗号分隔。

Key

string

过滤参数。

None

Value

string

过滤参数的值。

None

返回参数

名称

类型

描述

示例值

object

Code

string

返回的状态码。

200

Message

string

请求返回消息。

说明

请求成功时该参数返回 Successful,请求失败时会返回请求异常信息(如错误码等)。

Successful

RequestId

string

请求 ID。

B6D17591-B48B-4D31-9CD6-9B9796B2****

Success

string

请求是否执行成功:

  • true:执行成功。

  • false:执行失败。

true

Data

object

AsyncResult

RequestKey

string

请求参数的 Key。

ResultId

string

结果 ID。

async__20ee808e72257f16a4fe024057ca****

State

string

当前状态:

  • RUNNING:正在运行。

  • SUCCESS:成功。

  • FAIL:失败。

SUCCESS

IsFinish

boolean

是否完成。

true

Data

object

数据。

Total

integer

查询的总记录数。

1

Count

array

慢日志数量趋势。

integer

慢日志个数。

100

Ts

array

关系型数据库只使用这个。

integer

第一个事件发生的时间,使用 UNIX 时间戳表示,单位:毫秒。

[ 1735098480000, 1735098540000, 1735098600000, 1735098660000, 1735098720000, 1735098780000 ]

TsEnd

array

无用,预留字段。

integer

查询结束时间戳。

暂无

Item

array

趋势指标。

object

具体项目名称。

NodeId

string

节点 ID。

r-bp1hi0wg57s3n0i3n8-db-0

Count

array

慢日志数量。

integer

慢日志数量。

100

InsItems

array

趋势指标。

说明

仅云数据库 MongoDB 版实例支持。

object

趋势指标。

说明

仅云数据库 MongoDB 版实例支持。

InsId

string

实例角色 ID。

说明

仅云数据库 MongoDB 版实例支持。

2492

InsRole

string

实例角色。

说明

仅云数据库 MongoDB 版实例支持。

userAdmin

Count

array

执行次数。

integer

执行次数。

1

Rt

array

总执行耗时,单位为秒。

number

总执行耗时,单位为秒。

[ 2.306, 1.141, 0.0, 4.538, 1.247, 1.972 ]

AvgRt

array

平均执行耗时。

number

平均执行耗时。

[ 1.593, 2.306, 1.141, 0.0, 1.5127, 1.247 ]

MaxRt

array

最大执行耗时,单位秒。

number

最大执行耗时,单位秒。

[ 1.593, 2.306, 1.141, 14.115 0.0, 1.972 ]

LockTime

array

总锁等待时间,单位秒。

number

总锁等待时间,单位秒。

[ 1.051, 1.007, 0.0, 0.755, 0.096, 0.0 ]

AvgLockTime

array

平均锁等待时间,单位为秒。

number

平均锁等待时间,单位为秒。

[ 1.051, 0.0, 0.3357, 0.755, 0.324, 0.814 ]

MaxLockTime

array

最大锁等待时间,单位为秒。

number

最大锁等待时间,单位为秒。

[ 1.051, 1.007, 0.755, 0.0, 0.05, 0.656 ]

RowsExamined

array

总扫描行数。

说明

目前支持该字段的数据库:云数据库 RDS MySQL 版、云数据库 RDS PostgreSQL 版、云原生数据库 PolarDB MySQL 版。

integer

总扫描行数。

说明

目前支持该字段的数据库:云数据库 RDS MySQL 版、云数据库 RDS PostgreSQL 版、云原生数据库 PolarDB MySQL 版。

[ 256, 1, 512, 0, 1476678, 24430 ]

AvgRowsExamined

array

平均扫描行数。

number

平均扫描行数。

[ 256.0, 256.3333, 512.0, 370860.1111, 0.0, 1.0 ]

MaxRowsExamined

array

最大扫描行数。

integer

最大扫描行数。

[ 256, 1, 512, 0, 1476678, 24430 ]

RowsSent

array

返回行数。

integer

返回行数。

[ 384, 256, 0, 207030, 4, 256 ]

AvgRowsSent

array

平均返回行数。

number

平均返回行数。

[ 128.0, 0.0, 256.0, 25878.75, 192.0, 72.7778 ]

MaxRowsSent

array

最大返回行数。

integer

最大返回行数。

[ 256, 207023, 0, 128, 0, 0 ]

KeysExamined

array

索引扫描行数。

说明

仅云数据库 MongoDB 版实例支持。

integer

索引扫描行数。

说明

仅云数据库 MongoDB 版实例支持。

[ 384, 256, 0, 207030, 4, 256 ]

AvgKeysExamined

array

平均索引扫描行数。

说明

仅云数据库 MongoDB 版实例支持。

number

平均索引扫描行数。

说明

仅云数据库 MongoDB 版实例支持。

[ 128.0, 0.0, 256.0, 25878.75, 192.0, 72.7778 ]

MaxKeysExamined

array

最大索引扫描行数。

说明

仅云数据库 MongoDB 版实例支持。

integer

最大索引扫描行数。

说明

仅云数据库 MongoDB 版实例支持。

[ 384, 256, 0, 207030, 4, 256 ]

DocExamined

array

扫描文档行数。

说明

仅云数据库 MongoDB 版实例支持。

integer

扫描文档行数。

说明

仅云数据库 MongoDB 版实例支持。

[ 256, 207023, 0, 128, 0, 0 ]

AvgDocExamined

array

平均扫描文档行数。

说明

仅云数据库 MongoDB 版实例支持。

number

平均扫描文档行数。

说明

仅云数据库 MongoDB 版实例支持。

[ 128.0, 0.0, 256.0, 25878.75, 192.0, 72.7778 ]

MaxDocExamined

array

最大扫描文档行数。

说明

仅云数据库 MongoDB 版实例支持。

integer

最大扫描文档行数。

说明

仅云数据库 MongoDB 版实例支持。

[ 256, 207023, 0, 128, 0, 0 ]

ReturnNum

array

返回行数。

说明

仅云数据库 MongoDB 版实例支持。

integer

返回行数。

说明

仅云数据库 MongoDB 版实例支持。

[ 256, 207023, 0, 128, 0, 0 ]

AvgReturnNum

array

平均返回行数。

说明

仅云数据库 MongoDB 版实例支持。

number

平均返回行数

说明

仅云数据库 MongoDB 版实例支持。

[ 128.0, 0.0, 256.0, 25878.75, 192.0, 72.7778 ]

MaxReturnNum

array

最大返回行数。

说明

仅云数据库 MongoDB 版实例支持。

integer

最大返回行数。

说明

仅云数据库 MongoDB 版实例支持。

[ 256, 207023, 0, 128, 0, 0 ]

IOWrites

array

I/O 写次数。

说明

仅云数据库 RDS SQL Server 版实例支持。

integer

I/O 写次数。

说明

仅云数据库 RDS SQL Server 版实例支持。

[ 256, 207023, 0, 128, 0, 0 ]

AvgIOWrites

array

平均 I/O 写次数。

说明

仅云数据库 RDS SQL Server 版实例支持。

number

平均 I/O 写次数。

说明

仅云数据库 RDS SQL Server 版实例支持。

[ 384, 256, 0, 207030, 4, 256 ]

MaxIOWrites

array

最大 I/O 写次数。

说明

仅云数据库 RDS SQL Server 版实例支持。

integer

最大 I/O 写次数。

说明

仅云数据库 RDS SQL Server 版实例支持。

[ 256, 1, 512, 0, 1476678, 24430 ]

LastRowsCountAffected

array

最后一条语句的影响行数。

说明

仅云数据库 RDS SQL Server 版实例支持。

integer

最后一条语句的影响行数。

说明

仅云数据库 RDS SQL Server 版实例支持。

[ 256, 207023, 0, 128, 0, 0 ]

AvgLastRowsCountAffected

array

平均最后一条语句的影响行数。

说明

仅云数据库 RDS SQL Server 版实例支持。

number

平均最后一条语句的影响行数。

说明

仅云数据库 RDS SQL Server 版实例支持。

[ 1.593, 2.306, 1.141, 0.0, 1.5127, 1.247 ]

MaxLastRowsCountAffected

array

最大最后一条语句的影响行数。

说明

仅云数据库 RDS SQL Server 版实例支持。

integer

平均最后一条语句的影响行数。

说明

仅云数据库 RDS SQL Server 版实例支持。

[ 1, 1, 3, 1, 2, 3 ]

LogicalIOReads

array

逻辑读次数。

说明

仅云数据库 RDS SQL Server 版实例支持。

integer

逻辑读次数。

说明

仅云数据库 RDS SQL Server 版实例支持。

[ 384, 256, 0, 207030, 4, 256 ]

AvgLogicalIOReads

array

平均逻辑读次数。

说明

仅云数据库 RDS SQL Server 版实例支持。

number

平均逻辑读次数。

说明

仅云数据库 RDS SQL Server 版实例支持。

[ 1.593, 2.306, 1.141, 0.0, 1.5127, 1.247 ]

MaxLogicalIOReads

array

最大逻辑读次数。

说明

仅云数据库 RDS SQL Server 版实例支持。

integer

最大逻辑读次数。

说明

仅云数据库 RDS SQL Server 版实例支持。

[ 124, 2, 24, 251, 191, 721 ]

PhysicalIOReads

array

物理读次数。

说明

仅云数据库 RDS SQL Server 版实例支持。

integer

物理读次数。

说明

仅云数据库 RDS SQL Server 版实例支持。

[ 324, 22, 254, 251, 191, 721 ]

AvgPhysicalIOReads

array

平均物理读次数。

说明

仅云数据库 RDS SQL Server 版实例支持。

number

平均物理读次数。

说明

仅云数据库 RDS SQL Server 版实例支持。

[ 128.0, 0.0, 256.0, 25878.75, 192.0, 72.7778 ]

MaxPhysicalIOReads

array

最大物理读次数。

说明

仅云数据库 RDS SQL Server 版实例支持。

integer

最大物理读次数。

说明

仅云数据库 RDS SQL Server 版实例支持。

[ 314, 242, 114, 351, 191, 721 ]

RowsCountAffected

array

影响的行数。

说明

仅云数据库 RDS SQL Server 版实例支持。

integer

影响的行数。

说明

仅云数据库 RDS SQL Server 版实例支持。

[ 34, 42, 14, 51, 91, 71 ]

AvgRowsCountAffected

array

平均影响的行数。

说明

仅云数据库 RDS SQL Server 版实例支持。

number

平均影响的行数。

说明

仅云数据库 RDS SQL Server 版实例支持。

[ 1.593, 2.306, 1.141, 14.115, 0.0, 1.783, 0.0, 1.972 ]

MaxRowsCountAffected

array

最大影响的行数。

说明

仅云数据库 RDS SQL Server 版实例支持。

integer

最大影响的行数。

说明

仅云数据库 RDS SQL Server 版实例支持。

[ 714, 442, 314, 151, 291, 521 ]

CPUTime

array

CPU 处理时长。单位:秒(s)。

说明

仅云数据库 RDS SQL Server 版实例支持。

number

CPU 处理时长。单位:秒(s)。

说明

仅云数据库 RDS SQL Server 版实例支持。

[ 1.051, 1.007, 0.755, 0.0, 0.05, 0.656 ]

AvgCPUTime

array

平均 CPU 处理时长。单位:秒(s)。

说明

仅云数据库 RDS SQL Server 版实例支持。

number

平均 CPU 处理时长。单位:秒(s)。

说明

仅云数据库 RDS SQL Server 版实例支持。

[ 2.306, 1.141, 0.0, 4.538, 1.247, 0.0 ]

MaxCPUTime

array

最大 CPU 处理时长。单位:秒(s)。

说明

仅云数据库 RDS SQL Server 版实例支持。

number

最大 CPU 处理时长。单位:秒(s)。

说明

仅云数据库 RDS SQL Server 版实例支持。

[ 2.306, 1.141, 0.0, 4.538, 1.247, 0.0 ]

Rows

array

integer

AvgRows

array

number

MaxRows

array

integer

Frows

array

integer

AvgFrows

array

number

MaxFrows

array

integer

Scnt

array

integer

AvgScnt

array

number

MaxScnt

array

integer

ErrorCode

integer

错误码。

10910

Message

string

错误信息。

Successful

Timestamp

integer

请求时间。

1645668213000

示例

正常返回示例

JSON格式

{
  "Code": "200",
  "Message": "Successful",
  "RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Success": "true",
  "Data": {
    "RequestKey": "无",
    "ResultId": "async__20ee808e72257f16a4fe024057ca****",
    "State": "SUCCESS",
    "IsFinish": true,
    "Data": {
      "Total": 1,
      "Count": [
        100
      ],
      "Ts": [
        0
      ],
      "TsEnd": [
        0
      ],
      "Item": [
        {
          "NodeId": "r-bp1hi0wg57s3n0i3n8-db-0",
          "Count": [
            100
          ],
          "InsItems": [
            {
              "InsId": "2492",
              "InsRole": "userAdmin",
              "Count": [
                1
              ]
            }
          ]
        }
      ],
      "Rt": [
        0
      ],
      "AvgRt": [
        0
      ],
      "MaxRt": [
        0
      ],
      "LockTime": [
        0
      ],
      "AvgLockTime": [
        0
      ],
      "MaxLockTime": [
        0
      ],
      "RowsExamined": [
        0
      ],
      "AvgRowsExamined": [
        0
      ],
      "MaxRowsExamined": [
        0
      ],
      "RowsSent": [
        0
      ],
      "AvgRowsSent": [
        0
      ],
      "MaxRowsSent": [
        0
      ],
      "KeysExamined": [
        0
      ],
      "AvgKeysExamined": [
        0
      ],
      "MaxKeysExamined": [
        0
      ],
      "DocExamined": [
        0
      ],
      "AvgDocExamined": [
        0
      ],
      "MaxDocExamined": [
        0
      ],
      "ReturnNum": [
        0
      ],
      "AvgReturnNum": [
        0
      ],
      "MaxReturnNum": [
        0
      ],
      "IOWrites": [
        0
      ],
      "AvgIOWrites": [
        0
      ],
      "MaxIOWrites": [
        0
      ],
      "LastRowsCountAffected": [
        0
      ],
      "AvgLastRowsCountAffected": [
        0
      ],
      "MaxLastRowsCountAffected": [
        0
      ],
      "LogicalIOReads": [
        0
      ],
      "AvgLogicalIOReads": [
        0
      ],
      "MaxLogicalIOReads": [
        0
      ],
      "PhysicalIOReads": [
        0
      ],
      "AvgPhysicalIOReads": [
        0
      ],
      "MaxPhysicalIOReads": [
        0
      ],
      "RowsCountAffected": [
        0
      ],
      "AvgRowsCountAffected": [
        0
      ],
      "MaxRowsCountAffected": [
        0
      ],
      "CPUTime": [
        0
      ],
      "AvgCPUTime": [
        0
      ],
      "MaxCPUTime": [
        0
      ],
      "Rows": [
        0
      ],
      "AvgRows": [
        0
      ],
      "MaxRows": [
        0
      ],
      "Frows": [
        0
      ],
      "AvgFrows": [
        0
      ],
      "MaxFrows": [
        0
      ],
      "Scnt": [
        0
      ],
      "AvgScnt": [
        0
      ],
      "MaxScnt": [
        0
      ]
    },
    "ErrorCode": 10910,
    "Message": "Successful",
    "Timestamp": 1645668213000
  }
}

错误码

HTTP status code

错误码

错误信息

描述

400 InvalidParams The request parameters are invalid.
403 NoPermission You are not authorized to do this action.

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

变更历史

更多信息,参考变更详情