Get Metrics for an Instance
/api/metric/allMetricsOverview
Example paths:
- For getting devices by source:
- All devices (WARNING: Selecting all devices and all metrics could adversely affect system performance)
/api/metric/allMetricsOverview?DeviceSource=All&TimeRange=now-24h..now&MetricSource=MetricTypeName&MetricType=Latency&ShowMetricGroup=0&ExcludeDisabled=&page=1&start=0&limit=1000&group=%7B%22property%22%3A%22InstanceName%22%2C%22direction%22%3A%22ASC%22%7D
- Device group
/api/metric/allMetricsOverview?DeviceSource=DeviceGroup&TimeRange=now-24h..now&DeviceGroup=%2F%2FRoot%2F%2FPGs&MetricSource=MetricTypeName&MetricType=Latency&ShowMetricGroup=0&ExcludeDisabled=&page=1&start=0&limit=1000&group=%7B%22property%22%3A%22InstanceName%22%2C%22direction%22%3A%22ASC%22%7D
- Device zone
/api/metric/allMetricsOverview?DeviceSource=DeviceZone&TimeRange=now-24h..now&DeviceZoneID=2&MetricSource=MetricTypeName&MetricType=Latency&ShowMetricGroup=0&ExcludeDisabled=&page=1&start=0&limit=1000&group=%7B%22property%22%3A%22InstanceName%22%2C%22direction%22%3A%22ASC%22%7D
- Single device
/api/metric/allMetricsOverview?id=router2.example.com%3Bz3&DeviceSource=Device&TimeRange=now-24h..now&MetricSource=MetricTypeName&MetricType=Latency&ShowMetricGroup=0&ExcludeDisabled=&page=1&start=0&limit=1000&group=%7B%22property%22%3A%22InstanceName%22%2C%22direction%22%3A%22ASC%22%7D
- Multiple devices
/api/metric/allMetricsOverview?id=router.example.com%3Bz3%2Crouter2.example.com%3Bz3&DeviceSource=MultipleDevices&TimeRange=now-24h..now&MetricSource=MetricTypeName&MetricType=Latency&ShowMetricGroup=0&ExcludeDisabled=&page=1&start=0&limit=1000&group=%7B%22property%22%3A%22InstanceName%22%2C%22direction%22%3A%22ASC%22%7D
- All devices (WARNING: Selecting all devices and all metrics could adversely affect system performance)
- For getting metrics by metric source:
- All metrics (WARNING: Selecting all devices and all metrics could adversely affect system performance)
/api/metric/allMetricsOverview?&id=router.example.com%3Bz3&DeviceSource=Device&TimeRange=now-24h..now&MetricSource=All&ShowMetricGroup=0&ExcludeDisabled=&page=1&start=0&limit=1000&group=%7B%22property%22%3A%22InstanceName%22%2C%22direction%22%3A%22ASC%22%7D
- Metric group
/api/metric/allMetricsOverview?id=router.example.com%3Bz3&DeviceSource=Device&TimeRange=now-24h..now&MetricSource=MetricGroup&MetricGroup=Device%20Health&ShowMetricGroup=0&ExcludeDisabled=&page=1&start=0&limit=1000&group=%7B%22property%22%3A%22InstanceName%22%2C%22direction%22%3A%22ASC%22%7D
- Single metric type
/api/metric/allMetricsOverview?id=router2.example.com%3Bz3&DeviceSource=Device&TimeRange=now-24h..now&MetricSource=MetricTypeName&MetricType=Latency&ShowMetricGroup=0&ExcludeDisabled=&page=1&start=0&limit=1000&group=%7B%22property%22%3A%22InstanceName%22%2C%22direction%22%3A%22ASC%22%7D
- Multiple metric types
/api/metric/allMetricsOverview?id=router.example.com%3Bz3&DeviceSource=Device&TimeRange=now-24h..now&MetricSource=MetricTypes&MetricTypes=%5B%7B%22MetricTypeID%22%3A3%2C%22MetricTypeName%22%3A%22Interface%20Inbound%20Bandwidth%22%2C%22Measurement%22%3A%22metrictype_Interface_Inbound_Bandwidth%22%7D%2C%7B%22MetricTypeID%22%3A60%2C%22MetricTypeName%22%3A%22Latency%22%2C%22Measurement%22%3A%22metrictype_Latency%22%7D%5D&ShowMetricGroup=0&ExcludeDisabled=&page=1&start=0&limit=1000&group=%7B%22property%22%3A%22InstanceName%22%2C%22direction%22%3A%22ASC%22%7D
- All metrics (WARNING: Selecting all devices and all metrics could adversely affect system performance)
Request
-
DeviceGroup: string
The device group. Only used if DeviceSource is set to DeviceGroup.Example:
//Root//Group1
-
DeviceSource: string
Which device or devices to include. If no source is set, it assumes a single device. Allowed Values:
- All
- DeviceGroup: Also set the DeviceGroup parameter to the device group name.
- DeviceZone: Also set the DeviceZoneName parameter to the device zone name.
- Device: Also set the id parameter to the device name.
- MultipleDevices: Also set the id parameter to the comma-separated list of device names.
Example:Device
-
DeviceZoneName: string
The device zone name. Only used if DeviceSource is set to DeviceZone.Example:
Oracle Lab - Network Equipment
-
ExcludeDisabled: boolean
Whether to exclude disabled devices (1) or not (0).
-
MetricGroup: string
The metric group to include. Only used if MetricSource is set to MetricGroup.Example:
Device Health
-
MetricSource: string
Which metrics to include. If no source is set, all metrics are included. Allowed Values:
- All
- MetricGroup: Also set the MetricGroup parameter to the metric group name.
- MetricTypeName: Also set the MetricType parameter to the metric type name.
- MetricTypes: Also set the MetricTypes parameter to the list of metric types.
Example:All
-
MetricType: string
The metric type to include. Only used if MetricSource is set to MetricTypeName.Example:
Latency
-
MetricTypes: array[object]
The list of metric types to include. Only used if MetricSource is set to MetricTypes.Example:
Latency
-
ShowMetricGroup: boolean
Whether the entire metric group should be included (1) or not (0). Only used if MetricSource is set to MetricTypeName or MetricTypes.
-
TimeRange:
Match All
-
string
Shorthand string that encompasses the start and end times in RFC3339 format or relative time literal format. It will take precedence over StartTime if both are passed in.Example:
now-24h..now
-
string
-
filter: object
The fields to filter the results by. You cannot filter by fields that contain a state.
This parameter's value uses the following JSON format:
{ "property": "property", "value": "propertyValue", "operator": "operator", "conjunction": "conjunction" }
If you use multiple JSON objects to combine filters, for example, to filter by several different device names, you cannot combine OR and AND conjunctions. The conjunction used for the last object applies to the entire list.-
conjunction:
string
Default Value:
OR
Allowed Values:[ "AND", "OR" ]
The conjunction between filters.Example:AND
-
operator:
string
Default Value:
LIKE
Allowed Values:[ "eq", "ne", "gte", "gt", "lte", "lt", "LIKE", "NOT LIKE", "re", "not re", "NOT IN" ]
The filter operation to use.Example:eq
-
property(required):
string
The name of the field to filter on.Example:
name
-
value(required):
string
The value of the field to filter on.Example:
test
-
conjunction:
string
-
group: object
The group parameter. It groups results by field and direction.
This parameters value uses the following JSON format:
{
"property": "property",
"direction": "direction"
}-
direction(required):
string
Allowed Values:
[ "ASC", "DESC" ]
The direction of the group.Example:ASC
-
property(required):
string
The field name to group by.Example:
name
-
direction(required):
string
-
id: string
A serialized device name or comma-separated list of serialized device names. Only used if the DeviceSource parameter is set to Device or MultipleDevices.Example:
router.example.com;z1 OR router.example.com
-
limit: integer(int32)
The number of records to limit results by. If you do not also set the start parameter, records start at 0.Example:
100
-
sort: object
The field and direction to sort results by. You cannot sort by fields that contain a state.
This parameters value uses the following JSON format: { "property": "property", "direction": "direction" }-
direction(required):
string
Allowed Values:
[ "ASC", "DESC" ]
The direction of the sort.Example:ASC
-
property(required):
string
The field to sort on.Example:
name
Example:[ { "property":"Name", "direction":"ASC" }, { "property":"Value", "direction":"DESC" } ]
-
direction(required):
string
-
start: integer(int32)
The page of results to start from. This parameter is ignored if you do not also set the limit parameter.Default Value:
0
Example:1
There's no request body for this operation.
Back to TopResponse
- application/json
200 Response
-
object
SuccessfulGetOperation
The response body for a successful get operation.
-
object
type
object
-
message: string
The response message.Example:
Loaded 1 entries
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
true
object
-
data: array
data
-
total: integer
The total number of results regardless of paging.Example:
1
object
-
Abbr: string
Metric AbbreviationExample:
s
-
Availability: number
Availability of the metric for the specified time range.Example:
80
-
AverageUtilization: number
The most recent value of the metric for the specified time rangeExample:
50
-
AverageValue: number
Mean value of the metric for the specified time range.Example:
1000
-
DeviceID: string
Device ID related to the following data.Example:
1555
-
DeviceName: string
Device NameExample:
router.example.com
-
DeviceZoneID: integer
Device Zone ID.Example:
9
-
DeviceZoneName: string
Device Zone NameExample:
Oracle Lab - Network Equipment
-
Direction: integer
Direction to sort this metric type in relation to TopN. 0 = descending, 1 = ascending.Example:
0
-
DNSName: string
DNS NameExample:
router.example.com
-
Factor: integer
FactorExample:
1
-
InstanceName: string
Instance NameExample:
Device
-
IPAddress: string
IP AddressExample:
1192.0.2.1
-
IPv6Address: string
IPv6 AddressExample:
2001:DB8::1
-
LastUtilization: number
The last utilization reported for the metric for the specified time rangeExample:
60
-
LastValue: number
The most recent value of the metric for the specified time rangeExample:
0.000558996200561523
-
Maximum: integer
MaximumExample:
0
-
MaximumUtilization: number
The maximum utilization of the metric for the specified time rangeExample:
100
-
MaximumValue: number
The maximum value of the metric for the specified time rangeExample:
5000
-
MDSID: string
A combination of the MetricID, DeviceID, and ShardID concatenated with an "_" underscore character.Example:
642677_1555_1
-
Measurement: string
MeasurementExample:
metrictype_Latency
-
MetricGroupID: integer
The metric group ID the metric belongs to.Example:
6
-
MetricID: integer
Metric ID related to the following data.Example:
642677
-
MetricTypeName: string
Metric Type NameExample:
Latency
-
MinimumUtilization: number
The minimum utilization of the metric for the specified time rangeExample:
0
-
MinimumValue: number
The minimum value of the metric for the specified time rangeExample:
0
-
ParentDeviceID: integer
Parent Device ID. It will be 0 if the device is not virtual. It will be another DeviceID if it is a virtual device.Example:
0
-
PeakUtilization: number
Peak utilization is the minimum or maximum depending on metric type direction.Example:
100
-
PeakValue: number
Peak value is the minimum or maximum depending on metric type direction.Example:
5000
-
PollTime: integer
Poll TimeExample:
60
-
ShardID: integer
Shard IDExample:
1
-
SourceInstanceName: string
Source Instance NameExample:
Device
-
SumValue: number
The sum of all values for the metric for the specified time rangeExample:
300000
-
Trend: integer
TrendExample:
oracle.doceng.json.BetterJsonNull@835718b
-
UnitDivision: integer
Unit DivisionExample:
60
Default Response
object
-
errors: array
errors
The list of errors reported. Validation errors will be keyed by record field.
-
message: string
The response message.Example:
Exception thrown
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
false
array
-
Array of:
object items
An error.
object
Examples
The following examples show how to use query parameters in Get Metrics for an Instance requests to filter the response. You should always filter or limit your metrics requests using the query parameters; attempting to return too many metrics may have a significant negative impact on performance. For example, do not attempt to get all metrics from all devices.
The examples use query parameters specific to metrics, such as those related to source, time range, and metric type, as well as standard pagination parameters, such as page, start, limit, and sort.
You can submit requests using cURL, an API client, or your browser.
Examples of Getting Metrics from Device Sources
The examples in this section show how to get a specific metric type (Latency) from different device sources.
To get latency metrics from all devices.
http://hostFQDN/api/metric/allMetricsOverview?DeviceSource=All&TimeRange=now-24h..now&MetricSource=MetricTypeName&MetricType=Latency&ShowMetricGroup=0&ExcludeDisabled=&page=1&start=0&limit=1000&group=%7B%22property%22%3A%22InstanceName%22%2C%22direction%22%3A%22ASC%22%7D
To get latency metrics from devices in a specific group (Group 1):
http://hostFQDN/api/metric/allMetricsOverview?DeviceSource=DeviceGroup&TimeRange=now-24h..now&DeviceGroup=%2F%2FGroup%2F%2F1&MetricSource=MetricTypeName&MetricType=Latency&ShowMetricGroup=0&ExcludeDisabled=&page=1&start=0&limit=1000&group=%7B%22property%22%3A%22InstanceName%22%2C%22direction%22%3A%22ASC%22%7D
To get latency metrics from devices in a specific zone (2):
http://hostFQDN/api/metric/allMetricsOverview?DeviceSource=DeviceZone&TimeRange=now-24h..now&DeviceZoneID=2&MetricSource=MetricTypeName&MetricType=Latency&ShowMetricGroup=0&ExcludeDisabled=&page=1&start=0&limit=1000&group=%7B%22property%22%3A%22InstanceName%22%2C%22direction%22%3A%22ASC%22%7D
To get latency metrics for a specific device (router2.example.com;z3):
http://hostFQDN/api/metric/allMetricsOverview?id=router2.example.com%3Bz3&DeviceSource=Device&TimeRange=now-24h..now&MetricSource=MetricTypeName&MetricType=Latency&ShowMetricGroup=0&ExcludeDisabled=&page=1&start=0&limit=1000&group=%7B%22property%22%3A%22InstanceName%22%2C%22direction%22%3A%22ASC%22%7D
To get latency metrics for multiple devices (router.example.com;z3 and router2.example.com;z3):
http://hostFQDN/api/metric/allMetricsOverview?id=router.example.com%3Bz3%2Crouter2.example.com%3Bz3&DeviceSource=MultipleDevices&TimeRange=now-24h..now&MetricSource=MetricTypeName&MetricType=Latency&ShowMetricGroup=0&ExcludeDisabled=&page=1&start=0&limit=1000&group=%7B%22property%22%3A%22InstanceName%22%2C%22direction%22%3A%22ASC%22%7D
Examples of Getting Metrics from Metric Sources
The examples in this section show how to get metrics for a specific device (router.example.com;z3) from different metric sources.
To get all metrics for router.example.com;z3:
http://hostFQDN/api/metric/allMetricsOverview?&id=router.example.com%3Bz3&DeviceSource=Device&TimeRange=now-24h..now&MetricSource=All&ShowMetricGroup=0&ExcludeDisabled=&page=1&start=0&limit=1000&group=%7B%22property%22%3A%22InstanceName%22%2C%22direction%22%3A%22ASC%22%7D
To get metrics from a specific metric group (Device Health):
http://hostFQDN//api/metric/allMetricsOverview?id=router.example.com%3Bz3&DeviceSource=Device&TimeRange=now-24h..now&MetricSource=MetricGroup&MetricGroup=Device%20Health&ShowMetricGroup=0&ExcludeDisabled=&page=1&start=0&limit=1000&group=%7B%22property%22%3A%22InstanceName%22%2C%22direction%22%3A%22ASC%22%7D
To get metrics of a single type (Latency):
http://hostFQDN/api/metric/allMetricsOverview?id=router2.example.com%3Bz3&DeviceSource=Device&TimeRange=now-24h..now&MetricSource=MetricTypeName&MetricType=Latency&ShowMetricGroup=0&ExcludeDisabled=&page=1&start=0&limit=1000&group=%7B%22property%22%3A%22InstanceName%22%2C%22direction%22%3A%22ASC%22%7D
To get metrics of multiple types (Interface Inbound Bandwidth Measurement and Latency):
http://hostFQDN/api/metric/allMetricsOverview?id=router.example.com%3Bz3&DeviceSource=Device&TimeRange=now-24h..now&MetricSource=MetricTypes&MetricTypes=%5B%7B%22MetricTypeID%22%3A3%2C%22MetricTypeName%22%3A%22Interface%20Inbound%20Bandwidth%22%2C%22Measurement%22%3A%22metrictype_Interface_Inbound_Bandwidth%22%7D%2C%7B%22MetricTypeID%22%3A60%2C%22MetricTypeName%22%3A%22Latency%22%2C%22Measurement%22%3A%22metrictype_Latency%22%7D%5D&ShowMetricGroup=0&ExcludeDisabled=&page=1&start=0&limit=1000&group=%7B%22property%22%3A%22InstanceName%22%2C%22direction%22%3A%22ASC%22%7D
Example of the Response Body
The following example shows the contents of a response body in JSON format:
{ "success": "true", "message": "Loaded 1 entries", "total": "1", "data": [ { "MetricID": "642677", "DeviceID": "1555", "ParentDeviceID": "0", "DeviceName": "router.example.com", "DNSName": "router.example.com", "IPAddress": "192.0.2.1", "IPv6Address": "2001:DB8::1", "DeviceZoneID": "1", "DeviceZoneName": "zone1", "Maximum": "0", "MetricTypeName": "Latency", "Measurement": "metrictype_Latency", "Abbr": "s", "MetricGroupID": "6", "UnitDivision": "60", "Direction": "0", "ShardID": "1", "InstanceName": "Device", "PollTime": "60", "Factor": "1", "SourceInstanceName": "Device", "MDSID": "642677_1555_1", "Availability": "80", "AverageValue": "1000", "MinimumValue": "0", "MaximumValue": "5000", "LastValue": 0.000558996200561523, "AverageUtilization": "50", "MinimumUtilization": "0", "MaximumUtilization": "100", "LastUtilization": "60", "SumValue": "300000", "Trend": null, "PeakValue": "5000", "PeakUtilization": "100" } ] }