@tresdoce-nestjs-toolkit/health NPM

⚠️ Es importante tener en cuenta que este módulo se encuentra implementado en el package @tresdoce-nestjs-toolkit/paas, ya que es una funcionalidad core para el starter.

Este módulo está pensada para ser utilizada en NestJS Starter, o cualquier proyecto que utilice una configuración centralizada, siguiendo la misma arquitectura del starter.

Glosario

📝 Requerimientos básicos

NestJS Starter
Node.js v20.18.0 or higher (Download)
YARN v1.22.19 or higher
NPM v10.9.0 or higher
NestJS v10.4.7 or higher (Documentación)

🛠️ Instalar dependencia

npm install -S @tresdoce-nestjs-toolkit/health

yarn add @tresdoce-nestjs-toolkit/health

⚙️ Configuración

El módulo tiene la capacidad de utilizar la configuración centralizada para poder realizar los health checks correspondientes a los servicios configurados.

Siguiendo la arquitectura del NestJS Starter, la información que se agrega en la configuración de los services impacta en los health checks para él readiness, como asi también el uso de ciertos servicios como elasticsearch, typeORM, Redis, Camunda, etc.

Utilizando la propiedad timeout para configurar el tiempo de respuesta del servicio, como también la propiedad healthPath para configurar la url a la cual realizar el ping check, si no se completa este campo, por defecto realiza el ping al dominio de la url.

//./src/config/configuration.ts
import { getSkipHealthChecks, Typings } from '@tresdoce-nestjs-toolkit/core';
import { registerAs } from '@nestjs/config';

export default registerAs('config', (): Typings.AppConfig => {
  return {
    //...
    health: {
      skipChecks: getSkipHealthChecks(process.env.SKIP_HEALTH_CHECKS),
    },
    services: {
      myApi: {
        url: process.env.MY_API_URL,
      },
      myApiTwo: {
        url: process.env.MY_API_TWO_URL,
        timeout: 5000,
        healthPath: '/health/endpoint/of/api',
      },
    },
    //...
  };
});

Health

skipChecks: Lista de servicios predefinida por arquitectura para skipear los ping checks del readiness, si no se requiere realizar un skipeo, lo recomendable es remover la variable y su configuración.

Type: String[]
Values: storage | memory | elasticsearch | redis | camunda | typeorm
Example: elasticsearch,memory

Services

timeout: Es tiempo de respuesta del servicio a consumir.

Type: Number
Default: 0

healthPath: Endpoint a realizar el ping check del servicio

Type: String
Default: /health/liveness

👨‍💻 Uso

Importar healthModule en módulo principal de nuestra aplicación.

//./src/app.module.ts
import { HealthModule } from '@tresdoce-nestjs-toolkit/health';

@Module({
  imports: [
    //...
    HealthModule,
    //...
  ],
  //...
})
export class AppModule {}

Para visualizar las respuestas de los endpoints, basta con navegar a /health/liveness y /health/readiness.

Liveness

Schema: <http|https>://<server_url><:port>/<app-context>/health/liveness Example: http://localhost:8080/v1/health/liveness

Response

{
  "status": "up"
}

Readiness

Schema: <http|https>://<server_url><:port>/<app-context>/health/readiness Example: http://localhost:8080/v1/health/readiness

Response

{
  "status": "ok",
  "info": {
    "myApi": {
      "status": "up"
    },
    "myApiTwo": {
      "status": "up"
    }
  },
  "error": {},
  "details": {
    "myApi": {
      "status": "up"
    },
    "myApiTwo": {
      "status": "up"
    }
  }
}

{
  "status": "error",
  "info": {
    "myApi": {
      "status": "up"
    }
  },
  "error": {
    "myApiTwo": {
      "status": "down",
      "message": "connect ECONNREFUSED myApiTwo.example.com"
    }
  },
  "details": {
    "myApi": {
      "status": "up"
    },
    "myApiTwo": {
      "status": "down",
      "message": "connect ECONNREFUSED myApiTwo.example.com"
    }
  }
}