Get Metrics for an Instance
get
/api/metric/AllMetricsOverview
Gets the metrics for the specified instance that match the query parameters.
Request
Query Parameters
-
DeviceGroup(required): string
The device group. Only used if DeviceSource is set to DeviceGroup.Example:
//Root//Group1
-
DeviceSource(required): 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(required): string
The device zone name. Only used if DeviceSource is set to DeviceZone.Example:
Oracle Lab - Network Equipment
-
ExcludeDisabled(required): boolean
Whether to exclude disabled devices (1) or not (0).
-
MetricGroup(required): string
The metric group to include. Only used if MetricSource is set to MetricGroup.Example:
Device Health
-
MetricSource(required): 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(required): string
The metric type to include. Only used if MetricSource is set to MetricTypeName.Example:
Latency
-
MetricTypes(required): array[object]
The list of metric types to include. Only used if MetricSource is set to MetricTypes.Example:
Latency
-
ShowMetricGroup(required): boolean
Whether the entire metric group should be included (1) or not (0). Only used if MetricSource is set to MetricTypeName or MetricTypes.
-
TimeRange(required): string
A shorthand string that encompasses StartTime and StopTime. Overwrites any value set for Start and StopTime.Example:
now-24h..now
-
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(required): string
A device name or comma-separated list of device names. Only used if the DeviceSource parameter is set to Device or MultipleDevices.Example:
router.example.com
-
limit: integer(int32)
The number of records to limit results by.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
-
direction(required):
string
-
start: integer(int32)
The page of results to start from.Default Value:
0
Example:1
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
Successful operation
Nested Schema : SuccessfulGetOperation
Type:
Show Source
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
Nested Schema : type
Type:
Show Source
object
-
data: array
data
-
total: integer
The total number of results regardless of paging.Example:
1
Nested Schema : metricAllMetricsOverviewRead
Type:
Show Source
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:
100.77.1.223
-
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:
5.58996200561523E-4
-
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@11893180
-
UnitDivision: integer
Unit DivisionExample:
60
Default Response
Failed operation
Root Schema : schema
Type:
Show Source
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
Nested Schema : errors
Type:
array
The list of errors reported. Validation errors will be keyed by record field.
Show Source
Nested Schema : items
Type:
object