Get Metrics for an Instance

get

/api/metric/allMetricsOverview

Gets the metrics for the specified instance that match the query parameters.
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
  • 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

Request

Query Parameters
  • The device group. Only used if DeviceSource is set to DeviceGroup.
    Example:
    //Root//Group1
  • 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
  • The device zone name. Only used if DeviceSource is set to DeviceZone.
    Example:
    Oracle Lab - Network Equipment
  • Whether to exclude disabled devices (1) or not (0).
  • The metric group to include. Only used if MetricSource is set to MetricGroup.
    Example:
    Device Health
  • 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
  • The metric type to include. Only used if MetricSource is set to MetricTypeName.
    Example:
    Latency
  • The list of metric types to include. Only used if MetricSource is set to MetricTypes.
    Example:
    Latency
  • Whether the entire metric group should be included (1) or not (0). Only used if MetricSource is set to MetricTypeName or MetricTypes.
  • Match All
    • 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
  • 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.
    • Default Value: OR
      Allowed Values: [ "AND", "OR" ]
      The conjunction between filters.
      Example: AND
    • 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
    • The name of the field to filter on.
      Example: name
    • The value of the field to filter on.
      Example: test
  • The group parameter. It groups results by field and direction.
    This parameters value uses the following JSON format:
    {
    "property": "property",
    "direction": "direction"
    }
  • 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
  • The number of records to limit results by. If you do not also set the start parameter, records start at 0.
    Example:
    100
  • 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" }
    Example:
    [
        {
            "property":"Name",
            "direction":"ASC"
        },
        {
            "property":"Value",
            "direction":"DESC"
        }
    ]
  • 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 Top

Response

Supported Media Types

200 Response

Successful operation
Body ()
Root Schema : schema
Match All
Show Source
Nested Schema : SuccessfulGetOperation
Type: object
The response body for a successful get operation.
Show Source
Nested Schema : type
Type: object
Show Source
Nested Schema : data
Type: array
Show Source
Nested Schema : metricAllMetricsOverviewRead
Type: object
Show Source

Default Response

Failed operation
Body ()
Root Schema : schema
Type: object
Show Source
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
An error.
Back to Top

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"
    }
  ]
}
Back to Top