[{"label":"Latest (v37.2)","version":"latest"},{"version":"v37.1"},{"version":"v37.0"},{"version":"v36.3"},{"version":"v36.2"},{"version":"v36.1"},{"version":"v36.0"},{"link":"https://developer.vmware.com/apis/1046/vmware-cloud-director","version":"v35.0"}]
vmware-cloud-director

Get Load Balancer Analytic Reports

Description

Retrieves analytics for a specific load balancer. Metrics are specified in the filter query along with time period and series resolution. Up to 5 metric series can be specified per report. All reports will span the same time period.

Report filters are encapsulated in a fiql filter query parameter. Sample filter: filter=(componentId==urn:vcloud:virtualservice:7d38ad7f-cd93-4501-8c40-6f61650ccda0; metric==l4_server.avg_total_rtt;metric==l7_server.avg_application_response_time;step==500;limit==100) Supported filters are:

  • componentId. The URN of the virtual service or pool for which metrics will be gathered. Only one should be specified. This is required.
  • metric. One or more metrics of interest. filter=(metric==l4_server.avg_total_rtt;metric==l7_server.avg_application_response_time) - This is required. Supported metrics can be found at the analytics/supportedMetrics endpoint.
  • step. The time resolution of the report, in seconds. This is required. Minimum supported resolution is 300 seconds (5 minutes).
  • limit. Optional. The number of data points to be returned. This is optional. Defaults to 59 where it can't be calculated.
  • startTime. Start time of the series. This is optional. Must be in ISO 8601 format (i.e. 2020-07-24T00:00:00). If not provided, start time is calculated from the step and end time.
  • endTime. End period of the series. This is optional. Must be in ISO 8601 format (i.e. 2020-07-24T00:00:00). Defaults to the time of latest collected data point.
This feature requires additional licensing.

Request

Request

URL

URL


get
https://{api_host}/cloudapi/1.0.0/loadBalancer/analyticReports
Copy

Query Parameters

Query Parameters

string
filter Optional

Filter for a query. FIQL format.


Authentication

Authentication

This operation uses the following authentication methods.

Response

Response

Response Body

Response Body

200 OK

Returns EdgeLoadBalancerAnalyticReports of type(s) application/json;version=36.3
{
	"values": [
		{
			"componentId": "string",
			"data": [
				{
					"timestamp": "string",
					"value": "string"
				}
			],
			"gatewayId": "string",
			"metric": "string",
			"statistics": {
				"endTime": "string",
				"max": 0,
				"mean": 0,
				"min": 0,
				"sampleSize": 0,
				"startTime": "string",
				"trend": 0
			},
			"units": "string"
		}
	]
}
values Optional

A Load Balancer Analytic Report. It represents a timeseries of Edge Gateway Load Balancer runtime data.

No error details were provided in the OpenAPI specification.

Code Samples

Code Samples

cURL Command

curl https://{api_host}/cloudapi/1.0.0/loadBalancer/analyticReports


[{"label":"Latest (v37.2)","version":"latest"},{"version":"v37.1"},{"version":"v37.0"},{"version":"v36.3"},{"version":"v36.2"},{"version":"v36.1"},{"version":"v36.0"},{"link":"https://developer.vmware.com/apis/1046/vmware-cloud-director","version":"v35.0"}]
vmware-cloud-director
Availability
Added in 35.0
Edge Gateway Load Balancer Analytics Operations
Feedback

Was this page helpful?