New Feature of Payara Platform 5.184: Automated Health Check Checker

Uncategorized

There has been a lot of noise around MicroProfile for quite a while now, and one of the specs provided by MicroProfile are Health Checks. The aim of this spec is to allow you to write a number of health checks that will run when you hit a specific endpoint, the intention being that this endpoint can be periodically poked by a container orchestrator to determine if an instance is responsive and healthy.

Obviously however, not all container environments will have a health checker feature, and while you can poke the /health endpoint yourself manually, this isn’t really practical or convenient for use as a proper health check. What this new feature we’ve introduced does is allow you to configure an automated check within Payara Server itself that will periodically poke the /health endpoint of all instances in a cluster, just as how the container manager would.

 

Configuration Options

As with most things in Payara Server, this service can be configured using either the Administration Console or by using asadmin commands. For Payara Micro, you will have to put the asadmin command in a post-boot command file.

 

Asadmin

The command to configure the checker is set-healthcheck-microprofile-health-checker-configuration (yes we’re already looking at changing the name!). It takes the following options:

  • –enabled – Whether the checker should run or not
  • –time – How frequently the checker should run if enabled – used in combination with –unit
  • –unit – The unit of time for how frequently the checker should run if enabled – used in combination with –time
  • –checkername – The name of the checker that you’ll see printed out in the log files
  • –timeout – How long the checker should wait to connect to a /health endpoint before timing out as a failure

The command also accepts the –dynamic option to allow you to have any changes you make take effect immediately.

 

Administration Console

As the service only currently runs from the DAS (in a Payara Server environment), the configuration page for the service can be found under server (Admin Server) > MicroProfile Healthcheck Checker. The options remain the same between the asadmin command and the admin console:

 

adminconsole

 

Future Plans

In the future we look to build upon this feature by allowing Payara Server to manage the lifecycle of other Payara Server and Payara Micro instances – starting and stopping them to help guarantee a specified level of service to bring some of the advantages of containerised environments to non-containerised ones (as well as allowing some fancy hybrid solutions I’m sure!) We’re also looking at integrating our pre-existing health check system with this feature (and MicroProfile Health!) for a more cohesive and fully featured health check system of both your applications and the Payara Server & Payara Micro instances running them.

 

Want to Try it Out? 

{{cta(‘4c7626f5-1e53-418e-90c8-add6e4af19c9’)}}

 

 

Comments (1)

Post a comment

Your email address will not be published. Required fields are marked *

Payara needs the contact information you provide to us to contact you about our products and services. You may unsubscribe from these communications at any time. For information on how to unsubscribe, as well as our privacy practices and commitment to protecting your privacy, please review our Legal & Privacy Policy.

  1. Aleks

    Hi,

    ist the 5.184 version ready for Java 11?

    Thanks. 🙂

    Greetings

Related Posts

4 minutes
Uncategorized

Leading the Way: Payara Platform Community 7 Beta Now Fully Jakarta EE 11 Certified

We’re excited to announce that Payara Platform Community 7 Beta application server is now fully certified as Jakarta EE 11 […]

New Releases 5 minutes
News

What’s New In The Payara Platform September 2025 Release?

The September 2025 release marks a significant milestone with Payara 7.2025.1.Beta1 advancing Jakarta EE 11 readiness, alongside focused improvements […]

Blue background with coral and fish. Left text: 'MONTHLY CATCH'. Right: laptop screen with tech tabs and Payara Community logo. 4 minutes
Community

The Payara Monthly Catch – August 2025

Welcome aboard the August 2025 issue of The Payara Monthly Catch! With summer in full swing, things may have felt […]