Health Checks

Introduction

WebTSM Service health checks can be used to determine the status of a service.

Some configuration may be necessary, for more information on available configuration options please refer to: Configuration Health Checks

Health Check Requests

There are two endpoints available for requesting the status of a service:

Check Live Status

In order to check if a service is up and running the following request may be used

CODE

GET /health/live

This request returns a status 200 OK "Healthy" response if the service is running and can be reached.

In case the service can not be reached no response will be returned, since the request can not be processed without an available service.

Check Ready Status

For more detailed information on the status of a service the following request is available:

CODE

GET /health/ready

This request will respond with 200 OK "Healthy" if all of the following conditions are met:

IntegratedIdentityProvider is enabled and the database connection configured for user management is reachable
All database connections are reachable
IdentityProvider is reachable (if configured)
Configured UnhealthyMemoryAllocationLimit is not exceeded

A 503 Service Unavailable "Unhealthy" response will be returned if one of the conditions listed above fails.

In case all "Healthy" conditions are met but the allocated memory exceeds the configured limit for the degraded status a 200 OK "Degraded" response will be returned.

Details to health checks, for example which condition was not met when getting an "Unhealthy" response, may be found in the log file.