Metric results

API call for retrieving detailed metric result.

[GET]: Metric Result

This method may be used to retrieve a specific service metric result.

Input

/metric_result/{hostname}/{metric_name}?[exec_time]

Path Parameters

Type Description Required Default value
hostname hostname of service endpoint YES
metric_name name of the metric YES

Url Parameters

Type Description Required Default value
exec_time The execution date of query in zulu format YES

Notes: exec_time : The execution date of query in zulu format. In order to get the correct execution time get status results for all metrics (under a given endpoint, service and endpoint group). ( GET /status/{report_name}/{lgroup_type}/{lgroup_name}/services/{service_name}/endpoints/{endpoint_name}/metrics List)

Headers

x-api-key: shared_key_value
Accept: application/json or application/xml

Response Code

Status: 200 OK

Response body

Example Request:

URL:

/api/v2/metric_result/www.example.com/httpd_check?exec_time=2015-06-20T12:00:00Z

Headers:

x-api-key: shared_key_value
Accept: application/json or application/xml

Example Response:

Code:

Status: 200 OK

Reponse body:

 {
   "root": [
     {
       "Name": "www.example.com",
       "Metrics": [
         {
           "Name": "httpd_check",
           "Service": "httpd",
           "Details": [
             {
               "Timestamp": "2015-06-20T12:00:00Z",
               "Value": "OK",
               "Summary": "httpd is ok",
               "Message": "all checks ok"
             }
           ]
         }
       ]
     }
   ]
 }

[GET]: Multiple Metric Results for a specific host, on a specific day

This method may be used to retrieve multiple service metric results for a specific host on a specific day

Input

/metric_result/{hostname}?[exec_time]

Path Parameters

Type Description Required Default value
hostname hostname of service endpoint YES

Url Parameters

Type Description Required Default value
exec_time The execution date of query in zulu format - timepart is irrelevant (can be 00:00:00Z) YES
filter Filter metric results by statuses: non-ok, ok, critical, warning NO

Notes: exec_time : The specific date of query in zulu format. The time part of the date is irrelevant because all metrics of that day are returned. ( GET /status/{report_name}/{lgroup_type}/{lgroup_name}/services/{service_name}/endpoints/{endpoint_name}/metrics List)

Headers

x-api-key: shared_key_value
Accept: application/json or application/xml

Response Code

Status: 200 OK

Response body

Example Request:

URL:

/api/v2/metric_result/www.example.com?exec_time=2015-06-20T00:00:00Z

Headers:

x-api-key: shared_key_value
Accept: application/json or application/xml

Example Response:

Code:

Status: 200 OK

Reponse body:

{
   "root": [
     {
       "Name": "www.example.com",
       "Metrics": [
         {
           "Name": "httpd_check",
           "Service": "httpd",
           "Details": [
             {
               "Timestamp": "2015-06-20T12:00:00Z",
               "Value": "OK",
               "Summary": "httpd is ok",
               "Message": "all checks ok"
             },
              {
               "Timestamp": "2015-06-20T18:00:00Z",
               "Value": "CRITICAL",
               "Summary": "httpd is critical",
               "Message": "some checks failed"
             },
              {
               "Timestamp": "2015-06-20T23:00:00Z",
               "Value": "OK",
               "Summary": "httpd is ok",
               "Message": "all checks ok"
             }
           ]
         },
         {
           "Name": "httpd_memory",
           "Service": "httpd",
           "Details": [
             {
               "Timestamp": "2015-06-20T06:00:00Z",
               "Value": "OK",
               "Summary": "memcheck ok",
               "Message": "memory under 20%"
             },
             {
               "Timestamp": "2015-06-20T09:00:00Z",
               "Value": "OK",
               "Summary": "memcheck ok",
               "Message": "memory under 20%"
             },
             {
               "Timestamp": "2015-06-20T18:00:00Z",
               "Value": "OK",
               "Summary": "memcheck ok",
               "Message": "memory under 20%"
             },
           ]
         }
       ]
     }
   ]
 }
Example Request with filter parameter set to non-ok:

URL:

/api/v2/metric_result/www.example.com?exec_time=2015-06-20T00:00:00Z&filter=non-ok

Headers:

x-api-key: shared_key_value
Accept: application/json or application/xml

Example Response using fitler parameter set to non-ok:

Code:

Status: 200 OK

Reponse body:

{
   "root": [
     {
       "Name": "www.example.com",
       "Metrics": [
         {
           "Name": "httpd_check",
           "Service": "httpd",
           "Details": [
              {
               "Timestamp": "2015-06-20T18:00:00Z",
               "Value": "CRITICAL",
               "Summary": "httpd is critical",
               "Message": "some checks failed"
              }
           ]
         }
       ]
     }
   ]
 }
Example Request with filter parameter set to ok:

URL:

/api/v2/metric_result/www.example.com?exec_time=2015-06-20T00:00:00Z&filter=ok

Headers:

x-api-key: shared_key_value
Accept: application/json or application/xml

Example Response using fitler parameter set to ok:

Code:

Status: 200 OK

Reponse body:

{
   "root": [
     {
       "Name": "www.example.com",
       "Metrics": [
         {
           "Name": "httpd_check",
           "Service": "httpd",
           "Details": [
             {
               "Timestamp": "2015-06-20T12:00:00Z",
               "Value": "OK",
               "Summary": "httpd is ok",
               "Message": "all checks ok"
             },
             {
               "Timestamp": "2015-06-20T23:00:00Z",
               "Value": "OK",
               "Summary": "httpd is ok",
               "Message": "all checks ok"
             }
           ]
         },
         {
           "Name": "httpd_memory",
           "Service": "httpd",
           "Details": [
             {
               "Timestamp": "2015-06-20T06:00:00Z",
               "Value": "OK",
               "Summary": "memcheck ok",
               "Message": "memory under 20%"
             },
             {
               "Timestamp": "2015-06-20T09:00:00Z",
               "Value": "OK",
               "Summary": "memcheck ok",
               "Message": "memory under 20%"
             },
             {
               "Timestamp": "2015-06-20T18:00:00Z",
               "Value": "OK",
               "Summary": "memcheck ok",
               "Message": "memory under 20%"
             },
           ]
         }
       ]
     }
   ]
 }