Configures the specifics of the Healthcheck hogging threads performance metric service.

This command is deprecated and will be removed in a future release as it has been replaced by the set-healthcheck-service-configuration command.


asadmin [asadmin-options] healthcheck-hoggingthreads-configure
[--target target]


Configures the Hogging Threads checker service settings. The checker will determine which running threads are hogging the CPU by calculating a percentage of usage with the ratio of elapsed time to the checker service execution interval and verifying if this percentage exceeds the threshold-percentage.



Options for the asadmin utility. For information about these options, see the asadmin help page.


Displays the help text for the subcommand.


This option helps specify the target on which you are configuring the hogging threads checker service. Valid values are:


Applies to the default server instance. This is the default value.


Applies to every server instance in the cluster.


Applies to a specified server instance.


Defaults to false. Enables or disables the healthcheck service


Defaults to false. When set to true, applies the changes without a server restart.


Unused option.


Unused option.


Defaults to 1. The amount of time units that the service will use to periodically monitor the metric.


Defaults to MINUTES. The time unit to set the frequency of the metric monitoring.

Must correspond to a valid java.util.concurrent.TimeUnit

Defaults to 95. The threshold value that this metric will be compared to mark threads as hogging the CPU.


Defaults to 3. The number of retries that the checker service will execute in order to identify a hogging thread.


Example 1 Identifying hogging threads

Monitoring which threads hog the CPU is extremely important since this can lead to performance degradation, deadlocks and extreme bottlenecks issues that web applications can incur. In some cases the defaults are all that is needed, but imagine that in a critical system you want to set the threshold percentage to 90%, and you want to make sure that the health check service guarantees the state of such threads with a retry count of 5.

Additionally, you want to set the frequency of this check for every 20 seconds.

Use this command to apply these settings:

asadmin healthcheck-hoggingthreads-configure --dynamic=true --threshold-percentage=90 --retry-count=5 --time=20 --unit=SECONDS

Exit Status


subcommand executed successfully


error in executing the subcommand

See Also