- 最新动态
- 功能总览
- 产品介绍
- 快速入门
- 用户指南
- 最佳实践
- API参考
- SDK参考
- 常见问题
- 视频帮助
-
更多文档
-
用户指南(阿布扎比区域)
- 产品介绍
- 快速入门
- 监控看板
- 资源分组
- 使用告警功能
- 主机监控
- 自定义监控
- 事件监控
- 任务中心
- 数据转储
- 云服务监控
- 审计云监控服务操作记录
- 权限管理
- 配额调整
- 支持监控的服务列表
-
常见问题
- 产品咨询
-
主机监控
- 什么是插件修复配置?
- 怎样让新购ECS实例中带有操作系统监控功能?
- 裸金属服务器安装Agent后,裸金属实例为何出现在“主机监控 > 弹性云服务器”列表中?
- Agent支持的系统有哪些?
- Agent不同插件状态说明及处理方式
- Agent状态切换或监控面板有断点该如何处理?
- 业务端口被Agent占用该如何处理?
- 如何创建委托?
- 不能创建委托该如何处理?
- 委托被占用该如何处理?
- 委托已失效该如何处理?
- 主机监控Agent对主机的性能会有影响吗?
- Agent插件状态显示“故障”该如何处理?
- Agent插件状态显示“已停止”该如何处理?
- Agent插件状态显示“运行中”但没有数据该如何处理?
- 如何排查Agent一键修复失败问题?
- Agent一键修复后无监控数据问题排查
- 告警通知或误告警
- 监控数据异常
- 监控指标含义
- 用户权限
- API参考(阿布扎比区域)
- 用户指南(巴黎区域)
- API参考 (巴黎区域)
- 用户指南(吉隆坡区域)
- API参考(吉隆坡区域)
- 用户指南(安卡拉区域)
- API参考(安卡拉区域)
-
用户指南(阿布扎比区域)
- 通用参考
链接复制成功!
查询指标列表
功能介绍
查询系统当前可监控指标列表,可以指定指标命名空间、指标名称、维度、排序方式,起始记录和最大记录条数过滤查询结果。
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。
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
请求消息
无
响应消息
- 响应参数
表3 响应参数 名称
参数类型
说明
metrics
Array of objects
指标对象列表。
详细参数请参见表4。
meta_data
Object
查询结果元数据信息,包括分页信息等。
详细参数请参见表6。
表4 metrics字段数据结构说明 名称
参数类型
说明
namespace
String
指标所属命名空间。
dimensions
Array of objects
指标维度列表。
详细参数请参见表5。
metric_name
String
指标名称,如cpu_util。
unit
String
指标单位。
表5 dimensions字段数据结构说明 名称
参数类型
说明
name
String
监控维度名称,例如弹性云服务器的维度为instance_id,可参考维度中key字段。
value
String
维度取值,例如弹性云服务器ID。
长度最短为1,最大为256。
- 响应样例
{ "metrics": [ { "namespace": "SYS.ECS", "dimensions": [ { "name": "instance_id", "value": "d9112af5-6913-4f3b-bd0a-3f96711e004d" } ], "metric_name": "cpu_util", "unit": "%" } ], "meta_data": { "count": 1, "marker": "SYS.ECS.cpu_util.instance_id:d9112af5-6913-4f3b-bd0a-3f96711e004d", "total": 7 } }
返回值
错误码
请参考返回错误码说明。