LIliongard
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

Request

  • Base URL
    https://example.app.liongard.com/api/v1
  • URL
    https://example.app.liongard.com/api/v1/metrics/bulk
  • Auth
    API key in header X-ROAR-API-KEY

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"
      }
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.