Rules Service healthcheck

  • 19 August 2022
  • 0 replies
  • 64 views

Userlevel 3
Badge +2

You can run a health check utility on a Rules Service by browsing

host:port/healthcheck

For example:

http://localhost:7782/healthcheck

where port is the Windows Service port number of the Rules Service you want to check.

Visiting the /healthcheck endpoint returns code 200 (OK) if everything is OK, and code 503 (Service unavailable) otherwise.

This API returns a JSON object with the following properties.

Property Description Type
timestamp The current date and time in format: Date value in format:
YYYY-MM-DD HH:MM:SS.sss
healthy An indication of whether the Rules Service runs successfully or not Boolean
application Name of the USoft application as known in Authorizer String
message Explanation of problem String

The application property is only displayed if the application is found running in the Rules Service.

The message property can show these messages:

Message Explanation
Application could not be found The application could not be found running in any Rules Engine.
Authorizer could not be found The Rules Service is running but cannot connect to USoft Authorizer.
Database unreachable The application cannot connect to the database.
Engine could not be found The Rules Service could not access any Rules Engine.
TBD (Error generated by the engine itself)
Unable to read the configuration The Rules Service was not successfully or fully configurated. This occurs when you do not pursue ure.config wizard until the last wizard step (Finish) included.

Examples

{
"timestamp" : "2022-08-19 16:00:39.228",
"healthy" : false,
"message" : "Unable to read the configuration"
}
{
"timestamp" : "2022-08-19 16:04:39.969",
"healthy" : true,
"application" : "TRAVEL"
}

 


0 replies

Be the first to reply!

Reply