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:ORAllowed Values:[ "AND", "OR" ]The conjunction between filters.Example:AND
- 
        operator: 
        string
        Default Value:LIKEAllowed 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:0Example: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.
objectExamples
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"
    }
  ]
}