Community Wiki

From (mt) Community Wiki

This method provides a way to retrieve current warnings for all services associated with the authenticated account. This method only provides warnings that are currently in progress (e.g. it will not return all warnings for exceeded thresholds over the past hour).

Request Info

The following URL and HTTP method should be used:

Response Info

The response will return an HTTP status code to indicate the general category of success or failure to the client. More specific error codes and messages will be contained in the response data itself, if provided. For more information on response codes and parsing response data, see Parsing API responses.

Sample Request

To get the warnings for the authenticated account in JSON format, do the following:

curl -D log.txt -s -X "GET" "https://api.mediatemple.net/api/v1/stats/warnings.json?apikey=a5h34sf62..."

Sample Response

Here is an example of the returned result:

{
  "multipleServiceWarnings" : {
    "timeStamp" : 1284599245,
    "serviceWarning" : [ {
      "host" : "vzd000.mediatemple.net",
      "serviceId" : 555,
      "warning" : [ {
        "stat" : "load1Min",
        "status" : "Warning",
        "value" : 16.0,
        "min" : 15,
        "max" : 24,
        "percent" : false,
        "description" : "This is an uhealthy server",
        "url" : "http://www.google.com/search?q=warning"
      }, {
        "stat" : "load5Min",
        "status" : "Warning",
        "value" : 24.0,
        "min" : 15,
        "max" : 24,
        "percent" : false,
        "description" : "This is an uhealthy server",
        "url" : "http://www.google.com/search?q=warning"
      }, {
        "stat" : "load15Min",
        "status" : "Critical",
        "value" : 31.99,
        "min" : 25,
        "max" : null,
        "percent" : false,
        "description" : "This server is in critical condition",
        "url" : "http://www.google.com/search?q=critical"
      } ]
    } ]
  }
}

The response above contains 3 warnings for a single service: load1Min (warning), load5Min (warning) and load15Min (critical). To get a list of the thresholds used to determine if a service has warnings, see Get warning thresholds. Note that only non-healthy (Warning, Critical, Offline) thresholds will be returned.

Response Fields

The fields in the result represent the following:

The fields for each Service Warning represent the following:

The fields for each warning represent the following: