找不到 API ? 点击 反馈吧
- 应用分组
- 主机监控
- 事件中心
- 自定义监控
- 日志监控
- 站点监控
- 云产品监控
- 查询指定监控项的最新监控数据DescribeMetricLast
- 查询指定云产品的指定监控项的监控数据DescribeMetricList
- 查询指定云产品的某个监控项的监控数据DescribeMetricData
- 查询云监控开放的监控项详情DescribeMetricMetaList
- 查询云监控支持的时序类监控项产品列表DescribeProjectMeta
- 删除监控数据导出配置DeleteExporterOutput
- 删除数据导出规则DeleteExporterRule
- 查询监控数据导出列表DescribeExporterOutputList
- 查询数据导出规则列表DescribeExporterRuleList
- 查询排序后的最新监控数据DescribeMetricTop
- 创建或者修改一个监控数据导出配置PutExporterOutput
- 创建或修改数据导出规则PutExporterRule
- 报警服务
- 企业云监控
- 其它
DescribeMetricTop
先查询指定云产品的指定监控项的最新监控数据,再查询该监控项排序后的监控数据
服务地址:
华东1(杭州)
参数配置
高级配置
输入参数
只看必填
注意事项
Period监控数据的统计周期
Namespace云产品的数据命名空间
MetricName云产品的监控项名称
StartTime查询监控数据的开始时间
EndTime查询监控数据的结束时间
Dimensions指定资源的监控维度
Orderby排序字段
OrderDesc排序方式
Length每页显示的记录条数
Express对查询出的现有结果进行实时计算的表达式
文档
调用结果
SDK 示例
CLI示例
相关示例
调用历史
错误码
流控
插件下载了解更多
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
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 |
变更历史
暂无变更历史