资源监控

 

GetMonitors

更新时间 2020-12-01

批量获取多个资源的多个监控数据,一次请求总数不能超过 100 个资源。 支持的资源类型和监控项可参考 GetMonitor

Request Parameters

Parameter name Type Description Required
resource_meters_pairs.n.resource String 资源 ID Yes
resource_meters_pairs.n.meters String 多个监控项,如 ["cpu", "disk_rd-<volume id>"] Yes
step String 数据间隔时间,有效值为:5m, 15m, 2h, 1d。
(m 表示分钟,h 表示小时,d 表示天)
注解
若请求最近15天以内的数据,数据间隔最小可以到5m;若请求15天以上的数据,数据间隔可选2h 或 1d
Yes
start_time String 监控数据的起始 UTC 时间,格式为 2011-07-11T11:07:00Z Yes
end_time String 监控数据的结束 UTC 时间,格式为 2011-07-11T11:07:00Z Yes
zone String 区域 ID,注意要小写 Yes

公共参数

Response Elements

Name Type Description
action String 响应动作
monitors Array 监控数据集,可参见下面 监控数据集说明 和 Example
ret_code Integer 执行成功与否,0 表示成功,其他值则为错误代码

监控数据集说明

  • 云服务器的 cpu,memory 监控值表示 “使用的千分比”,若要计算百分比请 先将值除以10 。比如 API 返回的 cpu 监控数据值是 56,表示资源使用百分比为5.6% 。
  • 磁盘监控数据:
    • 磁盘吞吐量的监控数据单位是 B/s, 每组数据都包括两个值 [读, 写]。
    • 磁盘 IOPS 的监控数据单位就是 IOPS, 每组数据也包括两个值 [读, 写]。
    • 磁盘使用率的监控数据是类似这种格式 /|18|3319|15816 ,以 | 分隔表示 “mount 的路径”, “使用百分比”, “已使用空间(MB)”, “剩余可用空间(MB)”
  • 网络带宽的监控数据单位是 Bps (如果要换做 bps,记得每个值都乘以8),每组数据都包括两个值 [进, 出]。

Example

Example Request:

https://api.shanhe.com/iaas/?action=GetMonitors
&resource_meters_pairs.1.resource=i-hpqfipia
&resource_meters_pairs.1.meters=%5B%22cpu%22%2C%22memory%22%5D
&resource_meters_pairs.2.resource=i-m39k0aoy
&resource_meters_pairs.2.meters=%5B%22cpu%22%2C%22memory%22%5D
&start_time==2014-02-09T21%3A47%3A00.820Z
&end_time=2014-02-10T03%3A47%3A00.820Z
&step=5m
&zone=jn1
&COMMON_PARAMS

Example Response:

{
  "action":"GetMonitorsResponse",
  "monitors":[
    {
      "meter_set":[
        {
          "data":[
            [
              1543827000,
              327
            ],
            6,
            5
          ],
          "meter_id":"cpu"
        },
        {
          "data":[
            [
              1543827000,
              367
            ],
            330,
            330
          ],
          "meter_id":"memory"
        }
      ],
      "resource_id":"i-hpqfipia"
    },
    {
      "meter_set":[
        {
          "data":[
            [
              1543827000,
              106
            ],
            34,
            5
          ],
          "meter_id":"cpu"
        },
        {
          "data":[
            [
              1543827000,
              139
            ],
            140,
            143
          ],
          "meter_id":"memory"
        }
      ],
      "resource_id":"i-m39k0aoy"
    }
  ],
  "ret_code":0
}
这篇文档解决了您的问题吗?
0
0