fastify-graceful-healthcheck
TypeScript icon, indicating that this package has built-in type declarations

0.1.0 • Public • Published

fastify-graceful-healthcheck

NPM version NPM downloads

A fastify plugin to take care of the shutdown procedure of services that live behind a load balancer. This plugin will not initiate the shutdown process until it lets the load balancer know that it is shutting down. This way, the load balancer will not send any more requests to the server while it is shutting down and clients will not experience any downtime.

sequenceDiagram
  participant LB as Load Balancer
  participant App
  participant OS

  LB->>+App: GET /health
  App->>-LB: 200 OK
  Note left of LB: Let the app to join the pool
  LB->>+App: GET /health
  App->>-LB: 200 OK
  OS->>App: SIGTERM
  LB->>+App: GET /health
  App->>-LB: 503 Service Unavailable
  Note left of LB: Kick the app out of the pool
  LB->>+App: GET /health
  Note right of App: Run the shutdown procedure
  App->>-LB: 503 Service Unavailable

Install

npm i fastify-graceful-healthcheck

Usage

const fastify = require("fastify")();
const gracefulHealthCheck = require("fastify-graceful-healthcheck");

await fastify.register(gracefulHealthCheck, {
  endpoint: "/health",
  timeout: 10000,
  onShutdown: async () => {
    console.log("cleanup finished, server is shutting down");
    await fastify.close();
    process.exit(0);
  },
});

Options

Name Type Default Description
endpoint string /health The endpoint to check the health of the server.
onShutdown async function - The async function to run when the server is shutting down.
timeout number 25000 The timeout for the shutdown procedure in miliseconds

Note:

  1. The onShutdown function will be called only once, the default procedure is to close the fastify instance.
  2. Try to keep the endpoint to be known only to the load balancer to avoid the outside world from interfering with the shutdown process.

Versions

Current Tags

VersionDownloads (Last 7 Days)Tag
0.1.00latest

Version History

VersionDownloads (Last 7 Days)Published
0.1.00

Package Sidebar

Install

npm i fastify-graceful-healthcheck

Weekly Downloads

0

Version

0.1.0

License

MIT

Unpacked Size

19.3 kB

Total Files

13

Last publish

Collaborators

  • rromadhoni