介绍如何通过云监控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 }