appliance monitoring: query

Get monitoring data.

Request:

HTTP request

GET https://{server}/rest/appliance/monitoring/query

?item.interval=MINUTES30
&item.end_time=2015-01-01T22%3A13%3A05.651Z
&item.names.1=obj-103
&item.names.2=obj-103
&item.start_time=2015-01-01T22%3A13%3A05.651Z
&item.function=COUNT

Request Query Parameters:

Name Type Description
bold = required
item monitored_item_data_request MonitoredItemDataRequest Structure.
item.names string[] monitored item IDs Ex: CPU, MEMORY

When clients pass a value of this structure as a parameter, the field must contain identifiers for the resource type: com.vmware.appliance.monitoring. When operations return a value of this structure as a result, the field will contain identifiers for the resource type: com.vmware.appliance.monitoring.

item.interval string interval between values in hours, minutes

Defines interval between the values in hours and mins, for which aggregation will apply Value is one of:
MINUTES30: Thirty minutes interval between values. One week is 336 values.
HOURS2: Two hours interval between values. One month has 360 values.
MINUTES5: Five minutes interval between values (finest). One day would have 288 values, one week is 2016.
DAY1: 24 hours interval between values. One year has 365 values.
HOURS6: Six hour interval between values. One quarter is 360 values.

item.function string aggregation function

Defines aggregation function Value is one of:
COUNT: Aggregation takes count per period (sum)
MAX: Aggregation takes maximums per period
AVG: Aggregation takes average per period
MIN: Aggregation takes minimums per period

item.start_time date_time Start time in UTC

item.end_time date_time End time in UTC

Response:

HTTP Status Code: 200

Representation:

{
    "value"[
        {
            "data"[
                "string",
                "string"
            ],
            "end_time""2015-01-01T22:13:05.651Z",
            "function""COUNT",
            "interval""MINUTES30",
            "name""obj-103",
            "start_time""2015-01-01T22:13:05.651Z"
        },
        {
            "data"[
                "string",
                "string"
            ],
            "end_time""2015-01-01T22:13:05.651Z",
            "function""COUNT",
            "interval""MINUTES30",
            "name""obj-103",
            "start_time""2015-01-01T22:13:05.651Z"
        }
    ]
}

Response Type:

Name Type Description
bold = required
value monitored_item_data[] list of MonitoredItemData structure.
value[].name string Monitored item IDs Ex: CPU, MEMORY, STORAGE_TOTAL

When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: com.vmware.appliance.monitoring. When operations return a value of this structure as a result, the field will be an identifier for the resource type: com.vmware.appliance.monitoring.

value[].interval string interval between values in hours, minutes

Defines interval between the values in hours and mins, for which aggregation will apply Value is one of:
MINUTES30: Thirty minutes interval between values. One week is 336 values.
HOURS2: Two hours interval between values. One month has 360 values.
MINUTES5: Five minutes interval between values (finest). One day would have 288 values, one week is 2016.
DAY1: 24 hours interval between values. One year has 365 values.
HOURS6: Six hour interval between values. One quarter is 360 values.

value[].function string aggregation function

Defines aggregation function Value is one of:
COUNT: Aggregation takes count per period (sum)
MAX: Aggregation takes maximums per period
AVG: Aggregation takes average per period
MIN: Aggregation takes minimums per period

value[].start_time date_time Start time in UTC

value[].end_time date_time End time in UTC

value[].data string[] list of values

Errors:

HTTP Status Code Type Description
500 error Generic error