MetricsQuery

MetricsQuery
MetricsQuery
JSON Example
{
    "aggregate_entity": false,
    "aggregate_obj_id": false,
    "asn": "string",
    "attack": "string",
    "browser": "string",
    "client_insights": "string",
    "country": "string",
    "detailed_header": false,
    "devtype": "string",
    "dimension_aggregation": "string",
    "dimension_filter_op": "string",
    "dimension_limit": 0,
    "dimension_sampling": 0,
    "dimensions": [
        "string"
    ],
    "entity_uuid": "string",
    "id": "string",
    "include_refs": false,
    "include_statistics": false,
    "ipgroup": "string",
    "lang": "string",
    "limit": 0,
    "metric_entity": "string",
    "metric_id": "string",
    "microservice_levels": 0,
    "obj_id": "string",
    "order_by": "string",
    "os": "string",
    "pad_missing_data": false,
    "page": 0,
    "page_size": 0,
    "pool_uuid": "string",
    "prediction": false,
    "result_format": "string",
    "sampling_level": "string",
    "server": "string",
    "serviceengine_uuid": "string",
    "start": "string",
    "step": 0,
    "stop": "string",
    "tenant_uuid": "string",
    "url": "string",
    "validate_data": false
}
boolean
aggregate_entity
Optional

Required if the metrics need to be aggregated across multiple entities like virtualservice. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

boolean
aggregate_obj_id
Optional

Aggregate metrics for all the records for obj_id. When this is set obj_id is treated as a filter rather than a dimension. Field introduced in 17.2.1. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
asn
Optional

Autonomous System number. Eg. asn=3794. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
attack
Optional

Dos Attack ID filter. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
browser
Optional

Browser filter. Eg. browser=Chrome. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
client_insights
Optional

Client Insights Source Type - Active or Passive. Enum options - NO_INSIGHTS, PASSIVE, ACTIVE. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
country
Optional

Two letter country filter. Eg. country=US. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

boolean
detailed_header
Optional

Detailed header returns metric information, statistics etc. It is has overhead which can be bypassed if caller just wants raw data. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
devtype
Optional

Device type filter. Eg. devtype=desktop. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
dimension_aggregation
Optional

Aggregations for dimensions. Eg. use dimenstion_aggregation=avg for averaged metric values. Enum options - METRICS_DIMENSION_AGG_NONE, METRICS_DIMENSION_AGG_AVG, METRICS_DIMENSION_AGG_SUM, METRICS_DIMENSION_AGG_MAX, METRICS_DIMENSION_AGG_MIN, METRICS_DIMENSION_AGG_PERCENT, METRICS_DIMENSION_AGG_ALL. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
dimension_filter_op
Optional

Filters the obj_id based on the filter specified. Enum options - METRICS_FILTER_EQUALS, METRICS_FILTER_LIKE, METRICS_FILTER_CONTAINS, METRICS_FILTER_NOT_EQUALS. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

integer As uint32 As uint32
dimension_limit
Optional

Limit the number of dimensions in the result. specially useful in case of URLs. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

integer As int32 As int32
dimension_sampling
Optional

Deprecated. perform sampling for dimensional metrics. zero means auto. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

array of string
dimensions
Optional

Group by dimensions for the metrics. Eg. For results by single dimension use dimensions=browser. For results by browser and operating system use dimensions=browser,os. Enum options - METRICS_DIMENSION_METRIC_TIMESTAMP, METRICS_DIMENSION_COUNTRY, METRICS_DIMENSION_OS, METRICS_DIMENSION_URL, METRICS_DIMENSION_DEVTYPE, METRICS_DIMENSION_LANG, METRICS_DIMENSION_BROWSER, METRICS_DIMENSION_IPGROUP, METRICS_DIMENSION_ATTACK, METRICS_DIMENSION_ASN. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
entity_uuid
Optional

UUID of the entity. Eg. entity_uuid=virtualservice-0-1. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
id
Optional

ID of the request. In case of GET API it is returned in the metrics query response. In case of collections API responses are grouped byresponses corresponding to each optimized query. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

boolean
include_refs
Optional

Resolve UUID to names. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

boolean
include_statistics
Optional

Include metrics statistics with the request. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
ipgroup
Optional

IPGROUP filter Eg. UUID of the IP group. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
lang
Optional

Language filter. Eg. lang=english. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

integer As int32 As int32
limit
Optional

Max number of metric samples per metric requestedEg. limit=100 implies return only 100 samples. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
metric_entity
Optional

Describes the entity type for which metrics is requested. Eg. &metric_entity=VSERVER_METRICS_ENTITY. Enum options - VSERVER_METRICS_ENTITY, VM_METRICS_ENTITY, SE_METRICS_ENTITY, CONTROLLER_METRICS_ENTITY, APPLICATION_METRICS_ENTITY, TENANT_METRICS_ENTITY, POOL_METRICS_ENTITY. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
metric_id
Optional

Comma separated list of metrics requested.Eg. metric_id=l4_client.avg_bandwidth,l7_client.avg_total_responses. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

integer As uint32 As uint32
microservice_levels
Optional

number of levels of microservices map. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
obj_id
Optional

serverip port of the pool server. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
order_by
Optional

Order metrics series by metric timestamp. -metric_timestamp will result in most recent value first in the time series. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
os
Optional

Operating system filter. Eg. os=mac. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

boolean
pad_missing_data
Optional

Pad missing data when not available. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

integer As uint32 As uint32
page
Optional

page id for the query. Allowed only for aggregation queries. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

integer As uint32 As uint32
page_size
Optional

page size of the query. Allowed only for the aggregation queries. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
pool_uuid
Optional

metrics for a member pool in a virtual service. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

boolean
prediction
Optional

Request prediction values instead of actual observed metrics in future if supported. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
result_format
Optional

Deprecated. Please do not use this option. APIs only support JSON format. Enum options - METRICS_FORMAT_JSON, METRICS_FORMAT_CSV, METRICS_FORMAT_TXT, METRICS_FORMAT_PROTOBUF. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
sampling_level
Optional

Deprecated. Enum options - METRICS_SAMPLING_DEFAULT, METRICS_SAMPLING_FAST, METRICS_SAMPLING_FORCE. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
server
Optional

Pool Server ID in format server IP port. Eg. 10.10.1.42 80. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
serviceengine_uuid
Optional

UUID of the service engine.Eg. serviceengine_uuid=se-422ce810-50a4-2ecd-d45d-870656e99b7b. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
start
Optional

Start time for the metrics in ISO 8601 format. Default is UNIX Epoch. Eg. start=1970-01-01T00 00 00. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

integer As int32 As int32
step
Optional

Metrics time series returned with time points every time duration specified as step. Eg. if bandwidth is desired every 5 Secs then use step=5&metric_id=l4_client.avg_bandwidth. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
stop
Optional

End time for the metrics in ISO 8601 format. Default is now. Eg. stop=2014-01-01T12 42 42. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
tenant_uuid
Optional

UUID of the Tenant. . Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

string
url
Optional

URL filter. Eg. url=http //www.avinetworks.com. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.

boolean
validate_data
Optional

Validate every data before returning. This will result in increased latency and should only be used for troubleshooting. Allowed in Enterprise edition with any value, Essentials, Basic, Enterprise with Cloud Services edition.