History
Introduction
API Category
Making API Requests
Region APIs
Instance APIs
Cloud Hosting Cluster APIs
Image APIs
Instance Launch Template APIs
Placement Group APIs
Key APIs
Security Group APIs
Network APIs
Data Types
Error Codes
monitor.api.qcloud.comAction field for this API is GetMonitorData.Parameter | Required | Type | Description |
namespace | Yes | String | Namespace. Each Tencent Cloud service has a namespace. There are two namespaces for CLB: qce/lb_public for public network CLB and qce/lb_private for private network CLB. |
metricName | Yes | String | Monitoring metric to be obtained, such as `connum` for current connection, and `intraffic` for inbound bandwidth. For more information, see the table below. |
dimensions.n.name | Yes | String | Dimension name. You can use a combination of dimensions to get the monitoring data. Each namespace has different dimension structures as shown in the table below. This parameter should be used with `dimensions.n.value`. |
dimensions.n.value | Yes | String | Values of a specified dimension. |
startTime | No | Datetime | Start time such as 2017-01-01 00:00:00. The default time is 00:00:00 on the current day. |
endTime | No | Datetime | End time such as 2017-01-01 10:00:00. The current time is used by default. Note: it cannot be earlier than `startTime`, and we recommend configuring it on the same day as `startTime`. |
period | No | Int | Statistical period for monitoring data. Valid values: 60s and 300s. If this parameter is not passed in, 300s will be used by default. |
Metric | Description | Unit |
Connum | Current connections | - |
new_conn | New connections | - |
Intraffic | Inbound bandwidth | Mbps |
outtraffic | Outbound bandwidth | Mbps |
inpkg | Inbound packets | Packets/sec |
outpkg | Outbound packets | Packets/sec |
qce/lb_public namespace can be used to query all the monitoring data of the public network CLB instances.
qce/lb_public supports the following dimension groups:Dimension | Description | Format |
VIP | CLB VIP | IP address, such as 111.111.111.11 |
https://monitor.api.qcloud.com/v2/index.php?Action=GetMonitorData&namespace=qce/lb_public&metricName=connum&dimensions.0.name=vip&dimensions.0.value=111.111.111.11
Dimension | Description | Format |
VIP | CLB VIP | IP address, such as 111.111.111.11 |
loadBalancerPort | Port | Int, such as 80 |
protocol | Protocol | String, such as TCP |
https://monitor.api.qcloud.com/v2/index.php?Action=GetMonitorData&namespace=qce/lb_public&metricName=connum&dimensions.0.name=vip&dimensions.0.value=111.111.111.11&dimensions.1.name=loadBalancerPort&dimensions.1.value=80&dimensions.2.name=protocol&dimensions.2.value=tcp
Dimension | Description | Format |
VIP | CLB VIP | IP address, such as 111.111.111.11 |
loadBalancerPort | CLB port | Int, such as 80 |
protocol | Protocol | String, such as TCP |
vpcId | VPC ID of the CLB instance | Int, such as 1111 |
lanIp | IP address of the real server bound to the CLB instance | IP address, such as 111.111.111.11 |
https://monitor.api.qcloud.com/v2/index.php?Action=GetMonitorData&namespace=qce/lb_public&metricName=connum&dimensions.0.name=vip&dimensions.0.value=111.111.111.11&dimensions.1.name=loadBalancerPort&dimensions.1.value=80&dimensions.2.name=protocol&dimensions.2.value=tcp&dimensions.3.name=vpcId&dimensions.3.value=1111&dimensions.4.name=lanIp&dimensions.4.value=111.222.111.22
Dimension | Description | Format |
VIP | CLB VIP | IP address, such as 111.111.111.11 |
loadBalancerPort | CLB port | Int, such as 80 |
protocol | Protocol | String, such as TCP |
vpcId | VPC ID of the CLB instance | Int, such as 1111 |
lanIp | IP address of the real server bound to the CLB instance | IP address, such as 111.111.111.11 |
port | Port number of the real server bound to the CLB instance | Int, such as 80 |
https://monitor.api.qcloud.com/v2/index.php?Action=GetMonitorData&namespace=qce/lb_public&metricName=connum&dimensions.0.name=vip&dimensions.0.value=111.111.111.11&dimensions.1.name=loadBalancerPort&dimensions.1.value=80&dimensions.2.name=protocol&dimensions.2.value=tcp&dimensions.3.name=vpcId&dimensions.3.value=1111&dimensions.4.name=lanIp&dimensions.4.value=111.222.111.22&dimensions.5.name=port&dimensions.5.value=80
qce/lb_private namespace can be used to query all monitoring data of the private network CLB instance.vpcId is also required to uniquely specify a CLB instance:Dimension | Description | Format |
VIP | CLB VIP | IP address, such as 111.111.111.11 |
vpcId | VPC ID of the CLB instance | Int, such as 1111 |
https://monitor.api.qcloud.com/v2/index.php?Action=GetMonitorData&namespace=qce/lb_private&metricName=connum&dimensions.0.name=vip&dimensions.0.value=111.111.111.11&dimensions.1.name=vpcId&dimensions.1.value=1111
Dimension | Description | Format |
VIP | CLB VIP | IP address, such as 111.111.111.11 |
vpcId | VPC ID of the CLB instance | Int, such as 1111 |
loadBalancerPort | CLB port | Int, such as 80 |
protocol | Protocol | String, such as http |
https://monitor.api.qcloud.com/v2/index.php?Action=GetMonitorData&namespace=qce/lb_private&metricName=connum&dimensions.0.name=vip&dimensions.0.value=111.111.111.11&dimensions.1.name=vpcId&dimensions.1.value=1111&dimensions.2.name=loadBalancerPort&dimensions.2.value=80&dimensions.3.name=protocol&dimensions.3.value=http
vpcId is also required to uniquely specify a CLB instance:Dimension | Description | Format |
VIP | CLB VIP | IP address, such as 111.111.111.11 |
vpcId | VPC ID of the CLB instance | Int, such as 1111 |
loadBalancerPort | CLB port | Int, such as 80 |
protocol | Protocol | String, such as http |
lanIp | IP address of the real server bound to the CLB instance | IP address, such as 111.111.111.11 |
https://monitor.api.qcloud.com/v2/index.php?Action=GetMonitorData&namespace=qce/lb_private&metricName=connum&dimensions.0.name=vip&dimensions.0.value=111.111.111.11&dimensions.1.name=vpcId&dimensions.1.value=1111&dimensions.2.name=loadBalancerPort&dimensions.2.value=80&dimensions.3.name=protocol&dimensions.3.value=http&dimensions.4.name=lanIp&dimensions.4.value=111.222.111.22
Dimension | Description | Format |
VIP | CLB VIP | IP address, such as 111.111.111.11 |
vpcId | VPC ID of the CLB instance | Int, such as 1111 |
loadBalancerPort | CLB port | Int, such as 80 |
protocol | Protocol | String, such as http |
lanIp | IP address of the real server bound to the CLB instance | IP address, such as 111.111.111.11 |
port | Port number of the real server bound to the CLB instance | Int, such as 80 |
https://monitor.api.qcloud.com/v2/index.php?Action=GetMonitorData&namespace=qce/lb_private&metricName=connum&dimensions.0.name=vip&dimensions.0.value=111.111.111.11&dimensions.1.name=vpcId&dimensions.1.value=1111&dimensions.2.name=loadBalancerPort&dimensions.2.value=80&dimensions.3.name=protocol&dimensions.3.value=http&dimensions.4.name=lanIp&dimensions.4.value=111.222.111.22&dimensions.5.name=port&dimensions.5.value=80
qce/loadbalance namespace can be used to query the monitoring data of the CLB instance at the application layer. Metric | Description | Unit |
connum | Current (active) connections | Connections/min |
new_conn | New connections | Connections/min |
intraffic | Inbound traffic | Mbps |
outtraffic | Outbound traffic | Mbps |
inpkg | Inbound packets | Packets/sec |
outpkg | Outbound packets | Packets/sec |
httpCode_2XX | 2xx status codes | Codes/min |
httpCode_3XX | 3xx status codes | Codes/min |
httpCode_4XX | 4xx status codes | Codes/min |
httpCode_5XX | 5xx status codes | Codes/min |
httpCode_404 | 404 status codes | Codes/min |
httpCode_502 | 502 status codes | Codes/min |
response_time_max | Maximum response time | ms |
response_time_average | Average response time | ms |
response_timeout_num | Timed-out responses | Responses/min |
QPS | Requests per second | - |
Dimension | Description | Format |
VIP | CLB VIP | IP address, such as 111.111.111.11 |
https://monitor.api.qcloud.com/v2/index.php?Action=GetMonitorData&namespace=qce/loadbalance&metricName=connum&dimensions.0.name=vip&dimensions.0.value=111.111.111.11
Dimension | Description | Format |
VIP | CLB VIP | IP address, such as 111.111.111.11 |
loadBalancerPort | Port | Int, such as 80 |
protocol | Protocol | String, such as http |
https://monitor.api.qcloud.com/v2/index.php?Action=GetMonitorData&namespace=qce/loadbalance&metricName=connum&dimensions.0.name=vip&dimensions.0.value=111.111.111.11&dimensions.2.name=loadBalancerPort&dimensions.2.value=80&dimensions.3.name=protocol&dimensions.3.value=http
Dimension | Description | Format |
VIP | CLB VIP | IP address, such as 111.111.111.11 |
loadBalancerPort | Port | Int, such as 80 |
protocol | Protocol | String, such as http |
domain | Forwarding domain name | String, such as www.domain.com |
https://monitor.api.qcloud.com/v2/index.php?Action=GetMonitorData&namespace=qce/loadbalance&metricName=connum&dimensions.0.name=vip&dimensions.0.value=111.111.111.11&dimensions.1.name=domain&dimensions.1.value=www.domian.com&dimensions.2.name=loadBalancerPort&dimensions.2.value=80&dimensions.3.name=protocol&dimensions.3.value=http
Dimension | Description | Format |
VIP | CLB VIP | IP address, such as 111.111.111.11 |
loadBalancerPort | Port | Int, such as 80 |
protocol | Portocol | String, such as http |
domain | Forwarding domain name | String, such as www.domain.com |
url | Forwarding path | String, such as /url |
https://monitor.api.qcloud.com/v2/index.php?Action=GetMonitorData&namespace=qce/loadbalance&metricName=connum&dimensions.0.name=vip&dimensions.0.value=111.111.111.11&dimensions.1.name=domain&dimensions.1.value=www.domian.com&dimensions.2.name=loadBalancerPort&dimensions.2.value=80&dimensions.3.name=protocol&dimensions.3.value=http&dimensions.3.name=url&dimensions.3.value=/url
Dimension | Description | Format |
VIP | CLB VIP | IP address, such as 111.111.111.11 |
loadBalancerPort | Port | Int, such as 80 |
protocol | Portocol | String, such as http |
domain | Forwarding domain name | String, such as www.domain.com |
url | Forwarding path | String, such as /url |
vpcId | VPC ID of the CLB instance | Int, such as 1111 |
lanIp | IP address of the real server bound to the CLB instance | IP address, such as 111.111.111.11 |
https://monitor.api.qcloud.com/v2/index.php?Action=GetMonitorData&namespace=qce/loadbalance&metricName=connum&dimensions.0.name=vip&dimensions.0.value=111.111.111.11&dimensions.1.name=vpcId&dimensions.1.value=1111&dimensions.2.name=loadBalancerPort&dimensions.2.value=80&dimensions.3.name=protocol&dimensions.3.value=http&dimensions.4.name=lanIp&dimensions.4.value=111.222.111.22&dimensions.1.name=domain&dimensions.1.value=www.domian.com&dimensions.3.name=url&dimensions.3.value=/url
Dimension | Description | Format |
VIP | CLB VIP | IP address, such as 111.111.111.11 |
loadBalancerPort | Port | Int, such as 80 |
protocol | Protocol | String, such as http |
domain | Forwarding domain name | String, such as www.domain.com |
url | Forwarding path | String, such as /url |
vpcId | VPC ID of the CLB instance | Int, such as 1111 |
lanIp | IP address of the real server bound to the CLB instance | IP address, such as 111.111.111.11 |
port | Port number of the real server bound to the CLB instance | Int, such as 80 |
https://monitor.api.qcloud.com/v2/index.php?Action=GetMonitorData&namespace=qce/loadbalance&metricName=connum&dimensions.0.name=vip&dimensions.0.value=111.111.111.11&dimensions.1.name=vpcId&dimensions.1.value=1111&dimensions.2.name=loadBalancerPort&dimensions.2.value=80&dimensions.3.name=protocol&dimensions.3.value=http&dimensions.4.name=lanIp&dimensions.4.value=111.222.111.22&dimensions.5.name=port&dimensions.5.value=80&dimensions.1.name=domain&dimensions.1.value=www.domian.com&dimensions.3.name=url&dimensions.3.value=/url
Parameter | Type | Description |
code | Int | |
codeDesc | String | Error code. |
message | String | Detailed error message. |
startTime | Datetime | Start time. |
endTime | Datetime | End time. |
metricName | String | Metric name. |
period | Int | Statistical period for monitoring data. |
dataPoints | Object | Monitoring data list. Each element of the array stands for the data read at the monitoring time point. |
https://monitor.api.qcloud.com/v2/index.php?Action=GetMonitorData&namespace=qce/lb_public&metricName=connum&dimensions.0.name=protocol&dimensions.0.value=HTTP&dimensions.1.name=vip&dimensions.1.value=111.111.111.111&dimensions.2.name=loadBalancerPort&dimensions.2.value=80&startTime=2015-12-28 14:00:00&endTime=2015-12-28 14:05:00&period=300
{"code": 0,"message": "","metricName": "connum","startTime": "2015-12-28 14:00:00","endTime": "2015-12-28 14:05:00","period": 300,"dataPoints": [0]}
Dimension | Description | Format |
loadBalancerPort | Port | Int, such as 80 |
protocol | Protocol | String, such as http |
domain | Forwarding domain name | String, such as www.domain.com |
https://monitor.api.qcloud.com/v2/index.php?Action=GetMonitorData&namespace=qce/loadbalance&metricName=QPS&dimensions.0.name=domain&dimensions.0.value=www.domian.com&dimensions.1.name=loadBalancerPort&dimensions.1.value=80&dimensions.2.name=protocol&dimensions.2.value=http
피드백