Healthchecker utility

Posted by Martijn on Mon, Jun 5, 2023

Healthchecker

I made a simplistic Go utility that does a HTTP HEAD check to see if a server app is alive. Ideal for in distroless containers in my opinion.

All it does (and likely will ever do) is:

  • Send HTTP HEAD request to a specified URL;
  • On return of HTTP status code 200, exit with value 0;
  • Else exit with value 1;

Usage

  • Build it yourself or download a pre-built release.
  • Point it to your server’s URL.

Examples

On the commandline:

./healthchecker http://127.0.0.1:8080/api/v1/status

or in a Dockerfile:

1HEALTHCHECK --interval=5s --timeout=5s --retries=3 \
2    CMD ["/healthchecker", "http://127.0.0.1:8080/api/v1/status"]

Support

Source code and issues: https://github.com/mvdkleijn/healthchecker

Licensing

The healthchecker utility is made available under the MPL-2.0 license.

For more information on what that means in detail, you can read the license in full here: https://www.mozilla.org/en-US/MPL/