本接口用于查询相关云产品或功能的监控数据。
目前支持查询的产品或功能包括：边缘实例、弹性公网 IP、四层负载均衡、七层负载均衡、NAT 网关、文件存储、云盘、边缘函数、边缘容器和边缘托管。
系统存储最近 90 天的监控数据。在单次查询中，您最多可以查询 90 天存储时长内任意连续 31 天的数据。
如果您指定了多个筛选条件，系统会进行取交集查询，即查询满足所有筛选条件的监控数据。
默认情况下，如果您仅指定时间范围、未指定时间粒度，系统会按照您指定的时间范围来自动调整时间粒度：
指定的时间范围 | 默认的时间粒度 |
|---|---|
(0,6]小时 | 30 秒 |
(6,12]小时 | 1 分钟 |
(12,24]小时 | 2 分钟 |
(1,2]天 | 5 分钟 |
(2,7]天 | 15 分钟 |
(7,30]天 | 1 小时 |
(30,31] 天 | 3 小时 |
您可以设置 step 参数来指定时间粒度。该情况下，系统将按照您指定的时间粒度来展示数据。
下表列出了接口特定的请求参数以及公共请求参数 Action 和 Version。 其他公共参数，请参见公共参数。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
Action | String | 是 | DescribeMetricData | 公共参数。该参数表示接口名称。取值：DescribeMetricData。 |
Version | String | 是 | 2021-04-30 | 公共参数。该参数表示接口版本。取值：2021-04-30。 |
category | String | 是 | EIP | 监控指标类别：
详情请参见监控指标中的 category。 说明 对于文件存储功能，您需要先开通权限后才能查询相关数据。 |
dimensions | String | 否 | {"instances": ["36.**.**.190"]} | 查询维度。该参数值使用 JSON 字符串形式。 |
metric_name | String | 是 | network_io | 监控指标名称。详情请参见监控指标中的 metric_id。 |
start_time | Integer | 是 | 1638085378 | 查询起始时间，以 UNIX 时间戳格式显示。单位是秒。 |
end_time | Integer | 是 | 1638171778 | 查询结束时间，以 UNIX 时间戳格式显示。单位是秒。 |
step | Integer | 否 | 60 | 数据聚合的时间粒度。单位是秒。 |
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
metric | Map[String]String | | 监控指标信息。 |
data | []DataPair | | 监控数据。 |
peak | Float64 | 1 | 数据峰值。 |
peak_timestamp | Integer | 1691949691 | 数据峰值发生时的时间戳，单位：毫秒。 |
unit | String | bps | 单位。详情请参见监控指标中的 unit。 |
period | String | 15 | 数据聚合的时间粒度。 |
GET https://veenedge.volcengineapi.com/?Action=DescribeMetricData&Version=2021-04-30 &start_time=1691990070 &end_time=1691993670 &category=EIP &metric_name=network_io &dimensions={"instances":["122.**.**.176"]} &<其他公共参数>
{
"ResponseMetadata":{
"RequestId":"20230814141433D87D5C35931FA4A0****",
"Action":"DescribeMetricData",
"Version":"2021-04-30",
"Service":"veenedge",
"Region":"cn-north-1"
},
"Result":{
"result":[
{
"metric":{
"metric_id":"network_rx_io"
},
"data":[
{
"value":229.5876049235261,
"timestamp":1691990070000,
"is_loss":false
},
{
"value":92.7997348579004,
"timestamp":1691990085000,
"is_loss":false
},
{
"value":92.7997348579004,
"timestamp":1691990100000,
"is_loss":false
},
{
"value":93.40182800720528,
"timestamp":1691990115000,
"is_loss":false
},
{
"value":93.40182800720528,
"timestamp":1691990130000,
"is_loss":false
},
{
"value":362.86948080206207,
"timestamp":1691990145000,
"is_loss":false
},
{
"value":362.86948080206207,
"timestamp":1691990160000,
"is_loss":false
},
{
"value":686.2158388190704,
"timestamp":1691990175000,
"is_loss":false
},
{
"value":686.2158388190704,
"timestamp":1691990190000,
"is_loss":false
},
{
"value":478.97258450891667,
"timestamp":1691990205000,
"is_loss":false
},
{
"value":478.97258450891667,
"timestamp":1691990220000,
"is_loss":false
},
{
"value":153.330330781164,
"timestamp":1691990235000,
"is_loss":false
},
{
"value":153.330330781164,
"timestamp":1691990250000,
"is_loss":false
},
{
"value":19.99966667222213,
"timestamp":1691990265000,
"is_loss":false
},
{
"value":19.99966667222213,
"timestamp":1691990280000,
"is_loss":false
},
{
"value":151.731314724987,
"timestamp":1691990295000,
"is_loss":false
},
{
"value":151.731314724987,
"timestamp":1691990310000,
"is_loss":false
},
{
"value":150.6290094143131,
"timestamp":1691990325000,
"is_loss":false
},
{
"value":150.6290094143131,
"timestamp":1691990340000,
"is_loss":false
},
{
"value":19.8425821813612,
"timestamp":1691990355000,
"is_loss":false
},
{
"value":19.8425821813612,
"timestamp":1691990370000,
"is_loss":false
},
{
"value":0,
"timestamp":1691990385000,
"is_loss":false
},
{
"value":0,
"timestamp":1691990400000,
"is_loss":false
},
{
"value":0,
"timestamp":1691990415000,
"is_loss":false
},
{
"value":0,
"timestamp":1691990430000,
"is_loss":false
},
{
"value":438.4803880711464,
"timestamp":1691990445000,
"is_loss":false
},
{
"value":438.4803880711464,
"timestamp":1691990460000,
"is_loss":false
},
{
"value":860.6356968215159,
"timestamp":1691990475000,
"is_loss":false
}
}
],
"peak":860.6356968215159,
"peak_timestamp":1691990475000,
"unit":"bps",
"period":15
},
{
"metric":{
"metric_id":"network_tx_io"
},
"data":[
{
"value":229.5876049235261,
"timestamp":1691990070000,
"is_loss":false
},
{
"value":92.7997348579004,
"timestamp":1691990085000,
"is_loss":false
},
{
"value":92.7997348579004,
"timestamp":1691990100000,
"is_loss":false
},
{
"value":93.40182800720528,
"timestamp":1691990115000,
"is_loss":false
},
{
"value":93.40182800720528,
"timestamp":1691990130000,
"is_loss":false
},
{
"value":362.86948080206207,
"timestamp":1691990145000,
"is_loss":false
},
{
"value":362.86948080206207,
"timestamp":1691990160000,
"is_loss":false
},
{
"value":686.2158388190704,
"timestamp":1691990175000,
"is_loss":false
},
{
"value":686.2158388190704,
"timestamp":1691990190000,
"is_loss":false
},
{
"value":419.21746073995206,
"timestamp":1691990205000,
"is_loss":false
},
{
"value":419.21746073995206,
"timestamp":1691990220000,
"is_loss":false
},
{
"value":93.4127341573671,
"timestamp":1691990235000,
"is_loss":false
},
{
"value":93.4127341573671,
"timestamp":1691990250000,
"is_loss":false
},
{
"value":19.99966667222213,
"timestamp":1691990265000,
"is_loss":false
},
{
"value":19.99966667222213,
"timestamp":1691990280000,
"is_loss":false
},
{
"value":151.731314724987,
"timestamp":1691990295000,
"is_loss":false
},
{
"value":151.731314724987,
"timestamp":1691990310000,
"is_loss":false
},
{
"value":150.6290094143131,
"timestamp":1691990325000,
"is_loss":false
},
{
"value":150.6290094143131,
"timestamp":1691990340000,
"is_loss":false
},
{
"value":19.8425821813612,
"timestamp":1691990355000,
"is_loss":false
},
{
"value":19.8425821813612,
"timestamp":1691990370000,
"is_loss":false
},
{
"value":0,
"timestamp":1691990385000,
"is_loss":false
},
{
"value":0,
"timestamp":1691990400000,
"is_loss":false
},
{
"value":0,
"timestamp":1691990415000,
"is_loss":false
},
{
"value":0,
"timestamp":1691990430000,
"is_loss":false
},
{
"value":431.279067829102,
"timestamp":1691990445000,
"is_loss":false
},
{
"value":431.279067829102,
"timestamp":1691990460000,
"is_loss":false
},
{
"value":853.4012124459925,
"timestamp":1691990475000,
"is_loss":false
}
],
"peak":853.4,
"peak_timestamp":1691990475000,
"unit":"bps",
"period":15
}
]
}
}
如果响应正文中包含 Error 字段，则表示 API 请求失败。关于错误码的更多信息，参见错误码。