From 927e382fac7ee86386b5da4ed639439385863be0 Mon Sep 17 00:00:00 2001 From: Luana Dos Santos Date: Sat, 17 Jan 2026 19:24:44 -0300 Subject: [PATCH 1/3] W-20788085-app-restart-max-exceeded --- .../modules/ROOT/pages/worker-monitoring.adoc | 33 ++++++++++++++----- 1 file changed, 25 insertions(+), 8 deletions(-) diff --git a/cloudhub/modules/ROOT/pages/worker-monitoring.adoc b/cloudhub/modules/ROOT/pages/worker-monitoring.adoc index 218d7995f..e896b9f1f 100644 --- a/cloudhub/modules/ROOT/pages/worker-monitoring.adoc +++ b/cloudhub/modules/ROOT/pages/worker-monitoring.adoc @@ -66,20 +66,37 @@ If you change the flag `monitoringEnabled` via API, the application doesn't rest == How Automatic Restarts Work -If you select the *Automatically restart application when not responding* option, CloudHub monitors the worker and also automatically restarts the application if necessary. +If you select the *Automatically restart application when not responding* option, CloudHub monitors the worker and automatically attempts recovery using two mechanisms: application restarts and application relaunches. -CloudHub displays a notification that the app is restarting and another to report the success or failure of the restart. +=== Application Restarts -* If the restart succeeds, the ping script is reinitialized so that monitoring continues. -* If the restart fails, CloudHub continues to attempt restarting the app up to a total of five times. +CloudHub continuously checks the health of the worker JVM. +If the JVM becomes unresponsive, CloudHub restarts the application on the same worker instance. -After the maximum number of restart attempts is exceeded, CloudHub takes no further action. The monitoring script exits and the application is left unchanged until you manually intervene. +* If the restart succeeds, health monitoring continues. +* If the restart fails, CloudHub attempts up to five restarts. -The logs report the details of the restart procedure. +After five restart attempts, CloudHub stops trying to restart the application on that worker. -If you don't select the *Automatically restart application when not responding* option, the monitoring script exits and the application is left unchanged until you manually restart. +=== Application Relaunches -CloudHub displays a notification and a log message and takes no further action. +After CloudHub exhausts all restart attempts, it evaluates the worker state and attempts an application relaunch. +During an application relaunch, CloudHub terminates the failed worker and provisions a new worker instance. + +CloudHub attempts up to three application relaunches. + +If all relaunch attempts fail: + +* CloudHub stops automatic recovery. +* CloudHub sends you a notification. +* You must redeploy the application to restore it. + +The logs show the details of the restart and relaunch procedures. + +=== Without Automatic Restarts + +If you don't select the *Automatically restart application when not responding* option, CloudHub displays a notification and a log message when the application becomes unresponsive, but doesn't attempt automatic recovery. +You must manually restart the application. == See Also From 5b9aa01176780844263d7f25b8910ca50c8bb43b Mon Sep 17 00:00:00 2001 From: Luana Dos Santos <84200607+luanamulesoft@users.noreply.github.com> Date: Fri, 23 Jan 2026 16:39:41 -0300 Subject: [PATCH 2/3] Update cloudhub/modules/ROOT/pages/worker-monitoring.adoc Co-authored-by: Valkyrie Hunter --- cloudhub/modules/ROOT/pages/worker-monitoring.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/cloudhub/modules/ROOT/pages/worker-monitoring.adoc b/cloudhub/modules/ROOT/pages/worker-monitoring.adoc index e896b9f1f..deffa4e15 100644 --- a/cloudhub/modules/ROOT/pages/worker-monitoring.adoc +++ b/cloudhub/modules/ROOT/pages/worker-monitoring.adoc @@ -64,7 +64,7 @@ image::cloudhub-app-autorestart.png[Automatically restart application when not r [NOTE] If you change the flag `monitoringEnabled` via API, the application doesn't restart automatically and you must restart it manually. -== How Automatic Restarts Work +== How Automatic Restarts and Relaunches Work If you select the *Automatically restart application when not responding* option, CloudHub monitors the worker and automatically attempts recovery using two mechanisms: application restarts and application relaunches. From b08b5acf4390e951e27e3b2794fc7e0e662f9f44 Mon Sep 17 00:00:00 2001 From: Luana Dos Santos <84200607+luanamulesoft@users.noreply.github.com> Date: Fri, 23 Jan 2026 16:39:52 -0300 Subject: [PATCH 3/3] Update cloudhub/modules/ROOT/pages/worker-monitoring.adoc Co-authored-by: Valkyrie Hunter --- cloudhub/modules/ROOT/pages/worker-monitoring.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/cloudhub/modules/ROOT/pages/worker-monitoring.adoc b/cloudhub/modules/ROOT/pages/worker-monitoring.adoc index deffa4e15..007386728 100644 --- a/cloudhub/modules/ROOT/pages/worker-monitoring.adoc +++ b/cloudhub/modules/ROOT/pages/worker-monitoring.adoc @@ -89,7 +89,7 @@ If all relaunch attempts fail: * CloudHub stops automatic recovery. * CloudHub sends you a notification. -* You must redeploy the application to restore it. +* You must manually redeploy the application to restore it. The logs show the details of the restart and relaunch procedures.