Sign in

v1

latestOpenAPI 3.0.02026-07-249372139.7 KB
Metrics

Fetch Metric values for one or more systems

For each system ID passed, evaluates each metric ID/UUID passed for that system for the latest inspection data and returns the results. You can use this to build your own reports. You must pass a list of system IDs and metric IDs/UUIDs in the URL parameters. You can request values for up to 10 systems at a time. Setting includeNonVisible true allows you to get metric values without requiring you to toggle metrics to display within the Liongard UI.

get/metrics/bulk

Query parameters

systemsinteger[] required

List of system IDs

metricsinteger[]

List of metric IDs

uuidsstring[] required

List of metric UUIDs

includeNonVisibleboolean

If you want to include non-enabled metrics to be evaluated

Response

Returns a JSON object. The top level key corresponds to the system ID. Within each system, each key corresponds to a metric evaluation object, which contains information about which timeline entry was returned and what the metric evaluated to.

Example response

{
  "systemID": {
    "metricID": {
      "TimelineID": 1332180,
      "TimelineFinishedAt": "2021-09-10T19:21:03.195Z",
      "TimelineCreatedAt": "2021-09-10T19:21:03.195Z",
      "Metric": {
        "ID": 1,
        "Name": "Active Directory: Count of Joined Computers"
      }
    }
  }
}