Health API

The /health API endpoint

/health (GET)

The /health API endpoint provides HTTP GET access to [health][1] data for your Sensu instance.

EXAMPLE

The following example demonstrates a request to the /healths API, resulting in a JSON map containing Sensu [health data][1].

curl -s http://127.0.0.1:8080/api/core/v2/health -H "Authorization: Bearer TOKEN"
{
  "Alarms": null,
  "ClusterHealth": [
    {
      "MemberID": 9882886658148554927,
      "Name": "default",
      "Err": "",
      "Healthy": true
    }
  ]
}

API Specification

/health (GET)
description Returns health information about the Sensu instance
example url http://hostname:8080/api/core/v2/health
response type Map
response codes
  • Success: 200 (OK)
  • Error: 500 (Internal Server Error)
output
{
  "Alarms": null,
  "ClusterHealth": [
    {
      "MemberID": 9882886658148554927,
      "Name": "default",
      "Err": "",
      "Healthy": true
    }
  ]
}