Healthcheck

Creating healthchecks

Cabourotte provides several endpoints to create various kind of healthchecks. The payload is formatted as json, and should be a valid healthcheck definition.

The availables options for healthchecks are exactly the same than the one described in the configuration section.

If the parameter one-off is set to true in the payload, the healthcheck will be instantly executed and the result will be returned in the HTTP response (an example is available on this page). In that case, the healthcheck will not be periodically executed.

A bulk endpoint allows you to configure all healthchecks in one API call.

Create a HTTP healthcheck

• POST /healthcheck/http

curl -H "Content-Type: application/json" 127.0.0.1:9013/api/v1/healthcheck/http -d '{"name":"mcorbin-http-check","description":"http healthcheck example","target":"mcorbin.fr","interval":"5s","timeout": "3s","port":443,"protocol":"https","valid-status":[200]}'

{"message":"Healthcheck successfully added"}

Create a TCP healthcheck

• POST /healthcheck/tcp

curl -H "Content-Type: application/json" 127.0.0.1:9013/api/v1/healthcheck/tcp -d '{"name":"mcorbin-tcp-check","description":"http healthcheck example","target":"mcorbin.fr","interval":"5s","timeout": "3s","port":443}'

{"message":"Healthcheck successfully added"}

Create a DNS Healthcheck

• POST /healthcheck/dns

curl -H "Content-Type: application/json" 127.0.0.1:9013/api/v1/healthcheck/dns -d '{"name":"mcorbin-dns-check","description":"dns healthcheck example","domain":"mcorbin.fr","interval":"10s", "timeout":"5s"}'

{"message":"Healthcheck successfully added"}

Create a TLS Healthcheck

• POST /healthcheck/tls

curl -H "Content-Type: application/json" 127.0.0.1:9013/api/v1/healthcheck/tls -d '{"name":"mcorbin-tls-check","description":"tls healthcheck example","target":"mcorbin.fr","interval":"5s","timeout": "3s","port":443, "expiration-delay": "48h"}'

{"message":"Healthcheck successfully added"}

Create a command Healthcheck

• POST /healthcheck/command

curl -H "Content-Type: application/json" 127.0.0.1:9013/api/v1/healthcheck/command -d '{"name":"mcorbin-command-check","description":"command healthcheck example","command":"ls", "arguments": ["-l", "/"], "interval":"5s","timeout": "3s"}'

{"message":"Healthcheck successfully added"}

Create several healthchecks (bulk)

This endpoint can be used to create several healthchecks at once.

Existing healthchecks created using the API will be replaced or removed if not specified in the request payload. You can use this endpoint to be sure about which healthcheck was configured through the API.

• POST /healthcheck/bulk

curl -H "Content-Type: application/json" 127.0.0.1:9013/api/v1/healthcheck/bulk -d '
{
  "tls-checks": [
    {
      "name": "mcorbin-tls-check",
      "description": "tls healthcheck example",
      "target": "mcorbin.fr",
      "interval": "5s",
      "timeout": "3s",
      "port": 443,
      "expiration-delay": "48h"
    }
  ],
  "tcp-checks": [
    "..."
  ],
  "http-checks": [
    "..."
  ],
  "dns-checks": [
    "..."
  ],
  "command-checks": [
    "..."
  ]
}
'

{"message":"Healthchecks successfully added"}

Create a One-Off healthcheck

As explained before, the one-off parameter can be set to true in the payload to create a one-off healthcheck which will be instantly executed.

Success example:

curl -H "Content-Type: application/json" 127.0.0.1:9013/api/v1/healthcheck/dns -d '{"name":"mcorbin-dns-check","description":"dns healthcheck example","domain":"mcorbin.fr","timeout":"5s","one-off": true}'

{"message":"One-off healthcheck mcorbin-dns-check successfully executed"}

Error example:

curl -H "Content-Type: application/json" 127.0.0.1:9013/api/v1/healthcheck/dns -d '{"name":"mcorbin-dns-check","description":"dns healthcheck example","domain":"doesnotexist.mcorbin.fr","timeout":"5s","one-off": true}'

{"message":"Execution of one off healthcheck mcorbin-dns-check failed: Fail to lookup IP for domain: lookup doesnotexist.mcorbin.fr on 192.168.43.1:53: no such host"}

Delete a healthcheck

• DELETE /healthcheck/

curl -X DELETE 127.0.0.1:9013/api/v1/healthcheck/mcorbin-dns-check

{"message":"Successfully deleted healthcheck mcorbin-dns-check"}

List healthchecks

• GET /healthcheck

curl 127.0.0.1:9013/api/v1/healthcheck

{"result": [
    {
      "name": "mcorbin-dns-check",
      "description": "dns healthcheck example",
      "domain": "mcorbin.fr",
      "interval": "10s",
      "timeout": "5s",
      "one-off": false
    },
    {
      "name": "mcorbin-http-check",
      "valid-status": [
        200
      ],
      "description": "http healthcheck example",
      "target": "mcorbin.fr",
      "port": 443,
      "redirect": false,
      "protocol": "https",
      "timeout": "3s",
      "interval": "5s",
      "one-off": false
    }
  ]
}

Get a healthcheck

• GET /healthcheck/

curl 127.0.0.1:9013/api/v1/healthcheck/mcorbin-dns-check

{
  "name": "mcorbin-dns-check",
  "description": "dns healthcheck example",
  "domain": "mcorbin.fr",
  "timeout": "5s",
  "interval": "10s",
  "one-off": false
}