云监控服务 CES-查询指标列表:URI
下载云监控服务 CES用户手册完整版
URI
GET /V1.0/{project_id}/metrics
- 参数说明
表1 参数说明 名称
是否必选
说明
project_id
是
项目ID。
获取方式请参见获取项目ID。
表2 查询检索参数说明 名称
是否必选
参数类型
说明
namespace
否
String
查询服务的命名空间，各服务命名空间请参考支持监控的服务列表。
格式为service.item；service和item必须是字符串，必须以字母开头，只能包含0-9/a-z/A-Z/_，service.item总长度最短为3，最大为32。
metric_name
否
String
指标ID，例如弹性云服务器的监控指标CPU使用率，对应的metric_name为cpu_util。各服务监控指标请参考支持监控的服务列表。
字符格式必须以字母开头，只能包含0-9/a-z/A-Z/_-，字符长度最短为1，最大为96。
dim
否
String
监控维度，例如弹性云服务器的维度为instance_id。各服务维度请参考支持监控的服务列表。
目前最大支持3个维度，必须从0开始；维度格式为dim.{i}=key,value，key的最大长度32，value的最大长度为256。
单维度：dim.0=instance_id,6f3c6f91-4b24-4e1b-b7d1-a94ac1cb011d
多维度：dim.0=key,value&dim.1=key,value
start
否
String
分页起始值，格式为：namespace.metric_name.key:value
例如：start=SYS.ECS.cpu_util.instance_id:d9112af5-6913-4f3b-bd0a-3f96711e004d
limit
否
Integer
取值范围(0,1000]，默认值为1000。
用于限制结果数据条数。
order
否
String
用于标识结果排序方法，按时间戳排序。
取值说明，默认为desc：
- asc，升序
- desc，降序
- 请求样例
请求样例二：查询弹性云服务器ID为6f3c6f91-4b24-4e1b-b7d1-a94ac1cb011d的监控指标CPU使用率，结果按时间戳降序保留10条数据。
GET https://{云监控的终端节点}/V1.0/{project_id}/metrics?namespace=SYS.ECS&metric_name=cpu_util&dim.0=instance_id,6f3c6f91-4b24-4e1b-b7d1-a94ac1cb011d&limit=10&order=desc
