Health API

The /health API endpoint

/health (GET)

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

EXAMPLE

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

curl http://127.0.0.1:8080/health -H "Authorization: Bearer TOKEN"

HTTP/1.1 200 OK
{
  "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/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
    }
  ]
}