云服务器内容精选

  • 响应示例 状态码:200 查询成功 { "dimensions" : [ { "name" : "disk", "value" : "2e84018fc8b4484b94e89aae212fe615", "origin_value" : "vda" }, { "name" : "disk", "value" : "6a1b2de69eeb9a037ea23de6b529394d", "origin_value" : "vdc" } ], "count" : 10 }
  • 响应参数 状态码:200 表4 响应Body参数 参数 参数类型 描述 dimensions Array of AgentDimension objects 维度信息 count Integer 维度信息总数 取值范围: 0-2147483647 表5 AgentDimension 参数 参数类型 描述 name String 维度名称,枚举类型,类型有: mount_point:挂载点, disk:磁盘, proc:进程, gpu:显卡, raid: RAID控制器 枚举值: mount_point disk proc gpu raid value String 维度值,32位字符串,如:2e84018fc8b4484b94e89aae212fe615 origin_value String 实际维度信息,字符串,如:vda。 状态码:400 表6 响应Body参数 参数 参数类型 描述 error_code String 请求异常内部业务状态码 error_msg String 请求异常信息 request_id String 请求ID 状态码:404 表7 响应Body参数 参数 参数类型 描述 error_code String 请求异常内部业务状态码 error_msg String 请求异常信息 request_id String 请求ID 状态码:500 表8 响应Body参数 参数 参数类型 描述 error_code String 请求异常内部业务状态码 error_msg String 请求异常信息 request_id String 请求ID
  • URI GET /v2/{project_id}/instances/{instance_id}/agent-dimensions 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户ID 正则匹配:^[a-zA-Z0-9-]{1,64}$ instance_id 是 String 资源ID,如:4270ff17-aba3-4138-89fa-820594c39755。 表2 Query参数 参数 是否必选 参数类型 描述 dim_name 是 String 维度名称,枚举类型,类型有: mount_point:挂载点, disk:磁盘, proc:进程, gpu:显卡, raid: RAID控制器, 枚举值: mount_point disk proc gpu raid dim_value 否 String 维度值,32位字符串,如:2e84018fc8b4484b94e89aae212fe615。 offset 否 Integer 分页偏移量 取值范围: 0-2147483647 默认取值: 0 正则匹配:^(0|[1-9][0-9]*)$ limit 否 Integer 分页大小 取值范围: 1-1000 默认取值: 1000 正则匹配:^([1-9]|[1-9][0-9]|[1-9][0-9][0-9]|1000)$
  • URI GET /v1/{project_id}/metrics/pub 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户资源空间ID 表2 Query参数 参数 是否必选 参数类型 描述 filter 否 String 指标数据统计方式 period 否 Integer 指标数据统计周期,单位minute。 start_time 是 Long 获取指标数据起始时间 end_time 否 Long 获取指标数据结束时间 channel_id 是 String 事件通道id provider_type 否 String 事件目标类型/事件通道类型 source_name 否 String 事件源名称
  • 响应参数 状态码:200 表4 响应Body参数 参数 参数类型 描述 total Integer 总数 result Array of EventPubMetricsItem objects 指标列表 表5 EventPubMetricsItem 参数 参数类型 描述 event_size Long 事件大小 timestamp Long 时间戳 num Long 调用数 success_num Long 调用成功数 process_time Long 处理时间 invoke_time Long 调用时间
  • 响应示例 状态码:200 查询成功 { "dimensions" : [ { "name" : "disk", "value" : "2e84018fc8b4484b94e89aae212fe615", "origin_value" : "vda" }, { "name" : "disk", "value" : "6a1b2de69eeb9a037ea23de6b529394d", "origin_value" : "vdc" } ], "count" : 10 }
  • 为什么有的指标有明细,有的没有明细? 当某个指标是根据当前伙伴账号的业绩直接生成的,那么该指标可以查看指标明细。 当某个指标是伙伴维度,可能涉及多个账号的业绩汇总结果,那么该指标无法直接查看指标明细,需要伙伴在所有有业绩的账号下查看各个账号的指标明细。 当某个指标是增量或增长率等是基于某个指标的计算结果时,该指标无法直接查看指标明细,需要伙伴在具体的指标中分别查看两个账期的指标明细。 当某个指标不是基于伙伴业绩生成的,那么该指标也无法查看指标明细。 父主题: 指标管理
  • 响应示例 状态码: 400 { "error_code" : "EG.00014000", "error_msg" : "Bad request"} 状态码: 401 { "error_code" : "EG.00014010", "error_msg" : "Incorrect token or token resolution failed"} 状态码: 403 { "error_code" : "EG.00014030", "error_msg" : "No permissions to request this method"} 状态码: 404 { "error_code" : "EG.00014040", "error_msg" : "Not request resource found"} 状态码: 500 { "error_code" : "EG.00015000", "error_msg" : "Internal Server Error"}
  • 响应消息 响应参数 表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。 表6 meta_data字段数据结构说明 名称 参数类型 说明 count Integer 当前返回结果条数。 marker String 下一个开始的标记,用于分页。 如本次查询10条数据,第十条为cpu_util,下次start配置为cpu_util可从该指标开始查询。 total Integer 指标总条数。 响应样例 { "metrics": [ { "namespace": "SYS.E CS ", "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 }}
  • 返回值 正常 200 异常 返回值 说明 400 Bad Request 请求错误。 401 Unauthorized 未提供认证信息,或认证信息错误。 403 Forbidden 请求页面被禁止访问。 408 Request Timeout 请求超出了服务器的等待时间。 429 Too Many Requests 当前请求过多。 500 Internal Server Error 请求未完成,服务异常。 503 Service Unavailable 系统暂时不可用,请求受限。
  • 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,降序 请求样例 请求样例一:查询当前可监控所有指标列表。 GET https://{ 云监控 的终端节点}/V1.0/{project_id}/metrics 请求样例二:查询弹性云服务器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