Suppression logs

The monitoring service maintains a record of alarms that are suppressed during the time that a suppression is active. Suppression logs are accessible as a Time Series Collection. By default the API queries the last 7 days of suppression log information.

Use the following suppression logs API operations to create, view, update, and manage suppression logs.

List suppression logs

GET /suppression_logs

Lists suppression logs for this account.

Note

When a suppression log is written, the corresponding alarm changelog will be updated. Though no notification will be sent, the notification history will be updated to include a message saying that the notification was suppressed.

The following table shows the possible response codes for this operation:

Response Code	Name	Description
200	OK	Request completed.
401	Unauthorized	The system received a request from a user that is not authenticated.
403	Forbidden	The system received a request that the user is not authorized to make.
500	Internal Server Error	An unexpected condition was encountered.
503	Service Unavailable	The system is experiencing heavy load or another system failure.

Request

The following table shows the header parameters for the request:

Name	Type	Description
X-Auth-Token	String (Required)	A valid authentication token with administrative access. For details, see Get your credentials

Note

This operation does not accept a request body.

Response

Example List suppression logs: JSON response

{
    "values": [
        {
            "id": '5a628ca0-8ca4-11e3-811c-fb1e1c039d36',
            "entity_id": 'enXXXXX',
            "alarm_id": 'alXXXXX',
            "check_id": 'chXXXXX',
            "notification_plan_id": 'npXXXXX',
            "suppressions": [
                "spXXXXX"
            ],
            "state": 'OK',
            "timestamp": '1391412327018',
            "transaction_id": '.rh-Skiy.h-ord1-maas-stage-api1.r-zzTqFcaG.c-1553.ts-1391108878406.v-65f8f6c'
        }
    ],
    "metadata": {
        "count": 1,
        "limit": null,
        "marker": null,
        "next_marker": null,
        "next_href": null
    }
}