A library for adding reform standard compliant healthchecks to nodejs applications.
It exposes 3 endpoints:
/health- Returns 200 by default along with
buildInfo, can optionally include result evaluating all
checkspassed in config.
/health/livness- Returns 200 always.
/health/readiness- Returns 200 by default , can optionally include result evaluating all
readinessCheckspassed in config.
Configure an express.js handler with checks.
const config =checks:mySimpleWebCheck: healthcheckmyComplexWebCheck: healthcheckmyRawCheck: healthcheckbuildInfo:myCustomBuildInfo: "yay";healthcheck;
You can optionally include readiness checks.
const config =checks:mySimpleWebCheck: healthcheckmyComplexWebCheck: healthcheckmyRawCheck: healthcheckreadinessChecks:mySimpleWebCheck: healthcheckbuildInfo:myCustomBuildInfo: "yay";healthcheck;
what to include in readiness checks
- On Kubernetes, readiness probes will be called periodically throughout the lifetime of the container. Container will be made temporarily unavailable from serving traffic when the readiness check fails.
- The requests won't even reach your application to handle errors. So, it is very important to consider what checks should be included into readiness probe.
- While adding all dependant services to readiness check can help in identifying any misconfiguration during startup, it could cause unwanted downtime for the application.
- K8s introduced startUp Probes (Alpha in 1.16 ) to handle startup cases separately.
Based on above, you should include a dependency into readiness checks only if they are exclusive/hard dependencies for your service. Unavailability of soft dependencies needs to be handled in code to give appropriate customer experience.
Good example for check to be included in readiness:
- A private cache / database like
Elastic Searchwhich are exclusive to the application (not shared).
Bad example for check to be included in readiness:
- Any shared components like IDAM, S2S or CCD.
Bump the version (SemVer) and create a release in the GitHub UI, Travis CI will then build test and release to the npm registry.
Run yarn install (if packages not downloaded) and then run yarn test to run unit tests