通过API查看监控 - 用户指南| 阿里云

背景信息

通过API查看监控数据流程，如下图所示。

流程说明如下：

调用DescribeProjectMeta接口查询云监控中负载均衡的数据命名空间Namespace。
调用DescribeMetricMetaList接口查询云监控开放的时序类指标监控项描述或直接查看监控项说明，详情参见监控报警项说明。
查看监控项。
- 调用DescribeMetricLast接口查询负载均衡指定监控对象的最新监控数据。
- 调用DescribeMetricList接口查询负载均衡指定时间段内监控对象的时序指标监控数据。

本文以查询实例ID为lb-bp1r92vzpemy099*****，已配置七层监听的负载均衡实例的Qps监控项为例。

DescribeProjectMeta

调用DescribeProjectMeta接口查询云监控中负载均衡的数据命名空间Namespace，详情请参见DescribeProjectMeta。

将请求参数中报警产品标签过滤Labels的值设置为[{"name":"product","value":"SLB"}]，其他参数保持默认值。
请求示例：
```
http(s)://[Endpoint]/?Action=DescribeProjectMeta
&Labels=[{"name":"product","value":"SLB"}]
&<公共请求参数>
```

根据返回参数，获取云监控中负载均衡数据命名空间Namespace的值为acs_slb_dashboard。

返回示例：

{
    "PageSize": 30, 
    "RequestId": "75B895A2-62A4-411E-871C-0EED97CC0D26", 
    "PageNumber": 1, 
    "Total": 1, 
    "Resources": {
        "Resource": [
            {
                "Description": "负载均衡", 
                "Labels": "[{\"name\":\"product\",\"value\":\"SLB\"},{\"name\":\"productCategory\",\"value\":\"slb\"},{\"name\":\"groupFlag\",\"value\":\"true\"},{\"name\":\"cnName\",\"value\":\"负载均衡\"},{\"name\":\"enName\",\"value\":\"Server Load Balancer\"}]", 
                "Namespace": "acs_slb_dashboard"
            }
        ]
    }, 
    "Code": 200, 
    "Success": true
}

DescribeMetricMetaList

调用DescribeMetricMetaList接口查询云监控开放的时序类指标监控项描述，详情请参见DescribeMetricMetaList。

将请求参数中数据命名空间Namespace的值设置为acs_slb_dashboard，其他参数保持默认值。
请求示例：
```
http(s)://[Endpoint]/?Action=DescribeMetricMetaList
&Namespace=acs_slb_dashboard
&<公共请求参数>
```

根据返回参数，查看负载均衡的时序类指标监控项。可以查看本次示例中使用的监控项Qps是否存在。

返回示例：

{
    "TotalCount": 53, 
    "RequestId": "789846B4-56FC-4681-998C-5B7DBDFBE28F", 
    "Resources": {
        "Resource": [
            {
                "MetricName": "ActiveConnection", 
                "Periods": "60,300", 
                "Description": "端口当前活跃连接数", 
                "Dimensions": "userId,instanceId,port,protocol", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"Count\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"port\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "Count", 
                "Statistics": "Average,Minimum,Maximum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "DropConnection", 
                "Periods": "60,300", 
                "Description": "", 
                "Dimensions": "userId,instanceId,port,protocol", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"Count/Second\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"port\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "Count/s", 
                "Statistics": "Average,Minimum,Maximum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "DropPacketRX", 
                "Periods": "60,300", 
                "Description": "", 
                "Dimensions": "userId,instanceId,port,protocol", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"Count/Second\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"port\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "Count/s", 
                "Statistics": "Average,Minimum,Maximum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "DropPacketTX", 
                "Periods": "60,300", 
                "Description": "", 
                "Dimensions": "userId,instanceId,port,protocol", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"Count/Second\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"port\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "Count/s", 
                "Statistics": "Average,Minimum,Maximum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "DropTrafficRX", 
                "Periods": "60,300", 
                "Description": "", 
                "Dimensions": "userId,instanceId,port,protocol", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"bits/s\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"port\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "bits/s", 
                "Statistics": "Average,Minimum,Maximum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "DropTrafficTX", 
                "Periods": "60,300", 
                "Description": "", 
                "Dimensions": "userId,instanceId,port,protocol", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"bits/s\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"port\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "bits/s", 
                "Statistics": "Average,Minimum,Maximum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "GroupTrafficRX", 
                "Periods": "60", 
                "Description": "", 
                "Dimensions": "groupId", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"bits/s\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"groupId\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "bits/s", 
                "Statistics": "Average,Minimum,Maximum,Sum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "GroupTrafficTX", 
                "Periods": "60", 
                "Description": "", 
                "Dimensions": "groupId", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"bits/s\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"groupId\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "bits/s", 
                "Statistics": "Average,Minimum,Maximum,Sum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "HeathyServerCount", 
                "Periods": "60,300", 
                "Description": "当前后端健康ECS实例个数", 
                "Dimensions": "userId,instanceId,port,vip", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"Count\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"port\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "Count", 
                "Statistics": "Average,Minimum,Maximum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "InactiveConnection", 
                "Periods": "60,300", 
                "Description": "端口当前非活跃连接数", 
                "Dimensions": "userId,instanceId,port,protocol", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"Count\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"port\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "Count", 
                "Statistics": "Average,Minimum,Maximum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "InstanceActiveConnection", 
                "Periods": "60,300", 
                "Description": "", 
                "Dimensions": "userId,instanceId", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"Count/Second\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"instanceId\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "Count/s", 
                "Statistics": "Average,Minimum,Maximum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "InstanceDropConnection", 
                "Periods": "60,300", 
                "Description": "", 
                "Dimensions": "userId,instanceId", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"Count/Second\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"instanceId\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "Count/s", 
                "Statistics": "Average,Minimum,Maximum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "InstanceDropPacketRX", 
                "Periods": "60,300", 
                "Description": "", 
                "Dimensions": "userId,instanceId", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"Count/Second\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"instanceId\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "Count/s", 
                "Statistics": "Average,Minimum,Maximum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "InstanceDropPacketTX", 
                "Periods": "60,300", 
                "Description": "", 
                "Dimensions": "userId,instanceId", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"Count/Second\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"instanceId\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "Count/s", 
                "Statistics": "Average,Minimum,Maximum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "InstanceDropTrafficRX", 
                "Periods": "60,300", 
                "Description": "", 
                "Dimensions": "userId,instanceId", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"bits/s\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"instanceId\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "bits/s", 
                "Statistics": "Average,Minimum,Maximum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "InstanceDropTrafficTX", 
                "Periods": "60,300", 
                "Description": "", 
                "Dimensions": "userId,instanceId", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"bits/s\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"instanceId\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "bits/s", 
                "Statistics": "Average,Minimum,Maximum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "InstanceInactiveConnection", 
                "Periods": "60,300", 
                "Description": "", 
                "Dimensions": "userId,instanceId", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"Count/Second\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"instanceId\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "Count/s", 
                "Statistics": "Average,Minimum,Maximum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "InstanceMaxConnection", 
                "Periods": "60,300", 
                "Description": "", 
                "Dimensions": "userId,instanceId", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"Count/Second\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"instanceId\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "Count/s", 
                "Statistics": "Average,Minimum,Maximum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "InstanceMaxConnectionUtilization", 
                "Periods": "60,300", 
                "Description": "最大连接数使用率", 
                "Dimensions": "userId,instanceId", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"%\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"instanceId\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "%", 
                "Statistics": "Average,Maximum,Minimum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "InstanceNewConnection", 
                "Periods": "60,300", 
                "Description": "", 
                "Dimensions": "userId,instanceId", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"Count/Second\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"instanceId\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "Count/s", 
                "Statistics": "Average,Minimum,Maximum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "InstanceNewConnectionUtilization", 
                "Periods": "60,300", 
                "Description": "新建连接数使用率", 
                "Dimensions": "userId,instanceId", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"%\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"instanceId\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "%", 
                "Statistics": "Average,Maximum,Minimum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "InstancePacketRX", 
                "Periods": "60,300", 
                "Description": "", 
                "Dimensions": "userId,instanceId", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"Count/Second\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"instanceId\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "Count/s", 
                "Statistics": "Average,Minimum,Maximum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "InstancePacketTX", 
                "Periods": "60,300", 
                "Description": "", 
                "Dimensions": "userId,instanceId", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"Count/Second\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"instanceId\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "Count/s", 
                "Statistics": "Average,Minimum,Maximum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "InstanceQps", 
                "Periods": "60,300", 
                "Description": "", 
                "Dimensions": "userId,instanceId", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"Count/s\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"instanceId\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "Count/s", 
                "Statistics": "Average", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "InstanceQpsUtilization", 
                "Periods": "60,300", 
                "Description": "QPS使用率", 
                "Dimensions": "userId,instanceId", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"%\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"instanceId\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "%", 
                "Statistics": "Average,Maximum,Minimum", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "InstanceRt", 
                "Periods": "60,300", 
                "Description": "", 
                "Dimensions": "userId,instanceId", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"ms\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"instanceId\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "ms", 
                "Statistics": "Average", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "InstanceStatusCode2xx", 
                "Periods": "60,300", 
                "Description": "", 
                "Dimensions": "userId,instanceId", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"Count/Second\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"instanceId\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "Count/Second", 
                "Statistics": "Average", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "InstanceStatusCode3xx", 
                "Periods": "60,300", 
                "Description": "", 
                "Dimensions": "userId,instanceId", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"Count/Second\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"instanceId\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "Count/Second", 
                "Statistics": "Average", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "InstanceStatusCode4xx", 
                "Periods": "60,300", 
                "Description": "", 
                "Dimensions": "userId,instanceId", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"Count/Second\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"instanceId\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "Count/Second", 
                "Statistics": "Average", 
                "Namespace": "acs_slb_dashboard"
            }, 
            {
                "MetricName": "InstanceStatusCode5xx", 
                "Periods": "60,300", 
                "Description": "", 
                "Dimensions": "userId,instanceId", 
                "Labels": "[{\"name\":\"alertUnit\",\"value\":\"Count/Second\"},{\"name\":\"minAlertPeriod\",\"value\":\"60\"},{\"name\":\"metricCategory\",\"value\":\"instanceId\"},{\"name\":\"is_alarm\",\"value\":\"true\"}]", 
                "Unit": "Count/Second", 
                "Statistics": "Average", 
                "Namespace": "acs_slb_dashboard"
            }
        ]
    }, 
    "Code": 200, 
    "Success": true
}

DescribeMetricLast

调用DescribeMetricLast接口查询负载均衡指定监控对象的最新监控数据，本示例查看七层协议Qps的最新监控数据，详情请参见DescribeMetricLast。

四层和七层协议的监控项和监控指标不同，详情请参见监控报警项说明。

在请求参数中，设置查询Qps的参数。
需要配置以下参数，其他参数可保持默认值。
- MetricName：监控项名称，本示例设置为Qps。
- Dimensions：维度map，用于查询指定资源的监控数据，本示例设置为[{"instanceId":"lb-bp1r92vzpemy099f******"}]。
- Namespace：产品的数据命名空间，用于区分不同的产品，本示例设置为acs_slb_dashboard。
请求示例：
```
http(s)://[Endpoint]/?Action=DescribeMetricLast
&MetricName=Qps
&Namespace=acs_slb_dashboard
&Dimensions=[{"instanceId":"lb-bp1r92vzpemy099f******"}]
&<公共请求参数>
```

根据返回参数，查看Qps的最新监控数据。

返回示例：

{
    "RequestId": "B0EED5A2-7FE2-4A0C-B5E9-3D961F86DC9D", 
    "Period": "60", 
    "Datapoints": "[{\"timestamp\":1586248680000,\"userId\":\"16884015959*****\",\"instanceId\":\"lb-bp1r92vzpemy099f*****\",\"port\":\"80\",\"protocol\":\"http\",\"vip\":\"121.43.**.**\",\"Average\":0}]", 
    "Code": "200", 
    "Success": true
}

DescribeMetricList

调用DescribeMetricList接口查询负载均衡指定时间段内的时序指标监控数据，详情请参见DescribeMetricList。

在请求参数中，设置查询指定时间内Qps的监控数据。
需要配置以下参数，其他参数可保持默认值。
- MetricName：监控项名称，本次示例设置为Qps。
- Namespace：产品的数据命名空间，用于区分不同的产品，本次示例设置为acs_slb_dashboard。
- Dimensions：维度map，用于查询指定资源的监控数据，本示例设置为[{"instanceId":"lb-bp1r92vzpemy099f******"}]。
- StartTime：开始时间，StartTime不能等于或大于EndTime，本次示例设置为2020-03-28 00:10:00。
  支持格式：
  - Unix时间戳：从1970年1月1日开始所经过的秒数。
  - Format格式：YYYY-MM-DDThh:mm:ssZ。
- EndTime：结束时间，支持的格式和StartTime一致，本次示例设置为2020-03-28 00:11:00。
请求示例：
```
http(s)://[Endpoint]/?Action=DescribeMetricList
&MetricName=Qps
&Namespace=acs_slb_dashboard
&Dimensions=[{"instanceId":"lb-bp1r92vzpemy099f******"}]
&StartTime=2020-03-28 00:10:00
&EndTime=2020-03-28 00:11:00
&<公共请求参数>
```

根据返回参数，查看Qps在指定时间内的监控数据。

返回示例：

{
    "RequestId": "DFF0A853-0E37-4108-A9AF-5B3D609BD489", 
    "Period": "60", 
    "Datapoints": "[{\"timestamp\":1585325460000,\"userId\":\"168840159596****\",\"instanceId\":\"lb-bp1r92vzpemy099f******\",\"port\":\"80\",\"protocol\":\"http\",\"vip\":\"121.43.**.**\",\"Average\":0}]", 
    "Code": "200", 
    "Success": true
}

前提条件

背景信息

DescribeProjectMeta

DescribeMetricMetaList

DescribeMetricLast

DescribeMetricList