REST API for Alerts History

Important

The REST API is available when running Control Center in Normal mode only.

To access the Alerts REST API page:

  1. Click the Alerts bell icon in the top banner. The Alerts page opens to the History tab by default.
  2. Click the REST API tab.

The REST API page provides details of the alerts REST endpoint that can be used to programmatically obtain historical alert information.

After the alerts history starts populating, the Sample Response appears.

Populated Alerts GET REST API history page

Populated Alerts GET REST API history page

For more information, see REST API example.

REST API example

GET /2.0/alerts/history

Get the most recent alerts.

Query Parameters:
 
  • limit (int) – The maximum number of records to return
  • ts (long) – The most recent alert to return (in milliseconds since epoch)
Response JSON Object:
 
  • guid (string) – The unique ID of this alert
Response JSON Array of Objects:
 
  • timestamp (string) – Milliseconds since the epoch when this alert was issued
  • monitoringTrigger (map) – Trigger definition that caused this alert to be issued
  • monitoringTrigger.guid (string) – The unique ID of this trigger
  • monitoringTrigger.name (string) – The name of this trigger
  • triggers (array) – The trigger cause associated with monitoringTrigger
  • triggers[i].window (string) – Milliseconds since the epoch associated with the underlying data that caused this trigger was issued
  • actions (array) – Actions taken due to the firing of monitoringTrigger
  • actions[i].guid (string) – The unique ID of the action taken
  • actions[i].name (string) – The name of the action taken
  • actions[i].email (map) – The email address that the alert was sent to

Example request:

GET /2.0/alerts/history HTTP/1.1
Accept: application/json

Example response:

HTTP/1.1 200 OK
Content-Type: application/json

[
  {
    "guid": "50c0e74a-6368-43bf-bff7-fa51beff9ad9",
    "timestamp": "1516207447488",
    "monitoringTrigger": {
      "guid": "c8d72271-9f57-44b5-a6a4-97c97f0d1668",
      "name": "rock-cg-0 consumption"
    },
    "triggers": [
      {
        "window": "1516207320000",
        "hasError": false,
        "component": {
          "componentId": "rock-cg-0"
        },
        "longValue": "0"
      }
    ],
    "actions": [
      {
        "guid": "f593d79d-1bb7-4179-8997-6a7c8045dd8e",
        "name": "1212",
        "email": {
          "address": "sdfsdf@lskdjf.com",
          "subject": "skldfjlsdkfj"
        }
      }
    ]
  }
]