DescribeMetricTop
先查询指定云产品的指定监控项的最新监控数据,再查询该监控项排序后的监控数据
服务地址:
华东1(杭州)
输入参数
只看必填
Period监控数据的统计周期
Namespace云产品的数据命名空间
MetricName云产品的监控项名称
StartTime查询监控数据的开始时间
EndTime查询监控数据的结束时间
Dimensions指定资源的监控维度
Orderby排序字段
OrderDesc排序方式
Length每页显示的记录条数
Express对查询出的现有结果进行实时计算的表达式
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

使用限制

  • 调用 DescribeMetricLast、DescribeMetricList、DescribeMetricData 和 DescribeMetricTop 的接口,有 100 万次/月免费额度(总计),当免费额度用完且您没有开通基础云监控按量计费时,将无法正常使用该 API。如果您已开通基础云监控的按量计费,当免费调用额度用完时,该 API 仍然可以正常使用,超出免费额度部分将自动按使用量计费。开通方法详见开通按量计费
  • 单个 API 的调用次数限制为 10 次/秒。一个阿里云账号及该账号下的 RAM 用户共用 10 次/秒。

注意事项

各云产品监控数据的存储时长与Period(统计周期)有关,Period越大,查询的监控数据越稀疏,监控数据的存储时间越长,具体关系如下:

  • Period小于 60 秒,存储时长为 7 天。
  • Period等于 60 秒,存储时长为 31 天。
  • Period等于 300 秒,存储时长为 91 天。

使用说明

本文将提供一个示例,查询云服务acs_ecs_dashboard监控项cpu_idle在最近 60 秒的监控数据,并对监控数据的Average从大到小排序。

请求参数

字段名称字段详情
Periodstring

监控数据的统计周期。展开详情

示例值:60
Namespacestring

云产品的数据命名空间。展开详情

示例值:acs_ecs_dashboard参考取值来源:
    ModifyHybridMonitorNamespace
    CreateHybridMonitorNamespace
    DeleteHybridMonitorNamespace
    DescribeHybridMonitorNamespaceList
MetricNamestring

云产品的监控项名称。展开详情

示例值:cpu_idle参考取值来源:
    CreateMetricRuleTemplate
    DescribeMetricMetaList
StartTimestring

查询监控数据的开始时间。展开详情

示例值:2021-05-08 08:00:00
EndTimestring

查询监控数据的结束时间。展开详情

示例值:2021-05-08 10:00:00
Dimensionsstring

指定资源的监控维度。展开详情

示例值:[{"instanceId": "i-2ze2d6j5uhg20x47****"}]
Orderbystring

排序字段,即按该字段进行排序。取值:展开详情

示例值:Average
OrderDescstring

排序方式。取值:展开详情

示例值:false
Lengthstring

每页显示的记录条数。展开详情

示例值:10
Expressstring

对查询出的现有结果进行实时计算的表达式。展开详情

示例值:{"groupby":["userId","instanceId"]}

请求说明

关于公共请求参数的详情,请参见公共参数

返回参数

字段名称字段详情
Codestring

状态码。展开详情

示例值:200
Messagestring

错误信息。

示例值:The specified resource is not found.
RequestIdstring

请求 ID。

示例值:3121AE7D-4AFF-4C25-8F1D-C8226EBB1F42
Datapointsstring

监控数据列表。

示例值:[{\"order\":1,\"timestamp\":1620287520000,\"userId\":\"120886317861****\",\"instanceId\":\"i-j6ccf7d5fn335qpo****\",\"Average\":99.92,\"Minimum\":99.5,\"Maximum\":100.0,\"_count\":1.0},{\"order\":2,\"timestamp\":1620287520000,\"userId\":\"120886317861****\",\"instanceId\":\"i-0xii2bvf42iqvxbp****\",\"Average\":99.91,\"Minimum\":99.0,\"Maximum\":100.0,\"_count\":1.0}]
Periodstring

监控数据的统计周期。单位:秒。取值:15、60、900 和 3600。

示例值:60
变更历史
暂无变更历史