fish.payara.nucleus.healthcheck.preliminary

Class BaseHealthCheck<O extends HealthCheckExecutionOptions,C extends Checker>

java.lang.Object

fish.payara.nucleus.healthcheck.preliminary.BaseHealthCheck<O,C>

All Implemented Interfaces:

HealthCheckConstants

Direct Known Subclasses:

BaseThresholdHealthCheck, HoggingThreadsHealthCheck, StuckThreadsHealthCheck

@Contract
public abstract class BaseHealthCheck<O extends HealthCheckExecutionOptions,C extends Checker>
extends Object
implements HealthCheckConstants

Base class for all health check services

Since:

4.1.1.161

Author:

mertcaliskan

Field Summary

Fields

Modifier and Type	Field and Description
protected Class<C>	checkerType
protected HealthCheckService	healthCheckService
protected O	options

Fields inherited from interface fish.payara.nucleus.healthcheck.HealthCheckConstants

DEFAULT_CONNECTION_POOL_NAME, DEFAULT_CPU_USAGE_NAME, DEFAULT_ENABLED, DEFAULT_GARBAGE_COLLECTOR_NAME, DEFAULT_HEAP_MEMORY_USAGE_NAME, DEFAULT_HOGGING_THREADS_NAME, DEFAULT_MACHINE_MEMORY_USAGE_NAME, DEFAULT_RETRY_COUNT, DEFAULT_THRESHOLD_PERCENTAGE, DEFAULT_TIME, DEFAULT_UNIT, DEFUALT_STUCK_THEAD_NAME, FIVE_MIN, OLD_CONCURRENTMARKSWEEP, OLD_G1GC, OLD_MARK_SWEEP_COMPACT, OLD_PS_MARKSWEEP, ONE_GB, ONE_KB, ONE_MB, ONE_MIN, ONE_SEC, THRESHOLD_CRITICAL, THRESHOLD_DEFAULTVAL_CRITICAL, THRESHOLD_DEFAULTVAL_GOOD, THRESHOLD_DEFAULTVAL_WARNING, THRESHOLD_GOOD, THRESHOLD_WARNING, YOUNG_COPY, YOUNG_G1GC, YOUNG_PARNEW, YOUNG_PS_SCAVENGE

Constructor Summary

Constructors

Constructor and Description
BaseHealthCheck()

Method Summary

Modifier and Type	Method and Description
protected TimeUnit	asTimeUnit(String unit) Converts a string representing a timeunit to the value i.e.
protected HealthCheckExecutionOptions	constructBaseOptions(Checker checker)
abstract O	constructOptions(C c)
protected HealthCheckResultStatus	decideOnStatusWithDuration(long duration) Determines the level of of the healthcheck based on a time
abstract HealthCheckResult	doCheck()
Class<C>	getCheckerType()
protected abstract String	getDescription() The key for a human-friendly description of the healthcheck
O	getOptions()
protected <T extends BaseHealthCheck> O	postConstruct(T t, Class<C> checkerType)
protected String	prettyPrintBytes(long value) Returns the amount in a human-friendly string
protected String	prettyPrintStackTrace(StackTraceElement[] elements) Returns a string of tab-separated stack trace elements
String	resolveDescription() Returns a human-friendly description of the healthcheck
void	sendNotification(Level level, String message, Object[] parameters) Sends a notification to all notifier enabled with the healthcheck service.
void	setOptions(O options)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

healthCheckService

@Inject
protected HealthCheckService healthCheckService

options

protected O extends HealthCheckExecutionOptions options

checkerType

protected Class<C extends Checker> checkerType

Constructor Detail

BaseHealthCheck

public BaseHealthCheck()

Method Detail

doCheck

public abstract HealthCheckResult doCheck()

constructOptions

public abstract O constructOptions(C c)

postConstruct

protected <T extends BaseHealthCheck> O postConstruct(T t,
                                                      Class<C> checkerType)

constructBaseOptions

protected HealthCheckExecutionOptions constructBaseOptions(Checker checker)

asTimeUnit

protected TimeUnit asTimeUnit(String unit)

Converts a string representing a timeunit to the value i.e. "MILLISECONDS" to TimeUnit.MILLISECONDS

Parameters:

unit -

Returns:

decideOnStatusWithDuration

protected HealthCheckResultStatus decideOnStatusWithDuration(long duration)

Determines the level of of the healthcheck based on a time

Parameters:

duration - length of time taken in milliseconds

Returns:

HealthCheckResultStatus.CRITICAL if duration > 5 minutes; HealthCheckResultStatus.WARNING if duration > 1 minute; HealthCheckResultStatus.GOOD if duration > 0; otherwise HealthCheckResultStatus.CHECK_ERROR

prettyPrintBytes

protected String prettyPrintBytes(long value)

Returns the amount in a human-friendly string

i.e. with an input of 1024 the result will be "1 Kb"; for an input of 20000000 the result would be "19 Mb"

Result is always rounded down number of the largest unit of which there is at least one of that unit.

Unit can be Gb, Mb, Kb or bytes.

Parameters:

value -

Returns:

prettyPrintStackTrace

protected String prettyPrintStackTrace(StackTraceElement[] elements)

Returns a string of tab-separated stack trace elements

Parameters:

elements -

Returns:

resolveDescription

public String resolveDescription()

Returns a human-friendly description of the healthcheck

Returns:

Since:

4.1.2.173

getDescription

protected abstract String getDescription()

The key for a human-friendly description of the healthcheck

Returns:

getOptions

public O getOptions()

setOptions

public void setOptions(O options)

getCheckerType

public Class<C> getCheckerType()

sendNotification

public void sendNotification(Level level,
                             String message,
                             Object[] parameters)

Sends a notification to all notifier enabled with the healthcheck service.

The subject of the notification will be: "Health Check notification with severity level: ${level}

Parameters:

level - Level of the message to send

message - A simple message to send

parameters - An array of extra information to send