HSC

hsc (http-status-checker) is a command line utility used to perform multiple HTTP status checks on remote endpoints. It is a perfect fit if you need to host multiple HTTP server on the same EC2 instance behind an Elastic Load Balancer which unfortunately allow status checks on a single HTTP interface.

Usage

hsc supports accepts options passed as environment variables or as command line arguments. The short list of options is:

• p - env.PORT, in which port running the hsc server (default 9090)
• e - env.ENDPOINTS, comma separated list of endpoints to perform checks against

Install hsc globally with npm i -g http-status-checker

hsc to actually check the status of the endpoints monitored you can perform a GET request to http://your_ip:HSC_PORT/, if everything looks good hsc will simply answer with HTTP 200 "OK", otherwise with an HTTP 500 containiung in the body a JSON object indicating which endpoint failed the check and which one looks good, eg:

{
    http://google.com: "OK",
    http://www.yahoo.com: "OK",
    http://foobarservice.com: "getaddrinfo ENOTFOUND foobarservice.com foobarservice.com:80"
}

Usage example:

• hsc -p 9091 -e http://google.com,http://yahoo.com

Note

Logs are printed in JSON suing bunyan, if you want you can pipe them through the bunyan command line tool to read them better.