org.springframework.boot.actuate.health

Class Health

java.lang.Object

org.springframework.boot.actuate.health.HealthComponent

org.springframework.boot.actuate.health.Health

public final class Health
extends HealthComponent

Carries information about the health of a component or subsystem. Extends HealthComponent so that additional contextual details about the system can be returned along with the Status.

Health instances can be created by using Health.Builder's fluent API. Typical usage in a HealthIndicator would be:

 try {
        // do some test to determine state of component
        return Health.up().withDetail("version", "1.1.2").build();
 }
 catch (Exception ex) {
        return Health.down(ex).build();
 }
 

Since:

1.1.0

Author:

Christian Dupuis, Phillip Webb, Michael Pratt

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Health.Builder Builder for creating immutable Health instances.

Method Summary

Modifier and Type	Method and Description
static Health.Builder	down() Create a new Health.Builder instance with a Status.DOWN status.
static Health.Builder	down(Exception ex) Create a new Health.Builder instance with an Status.DOWN status and the specified exception details.
boolean	equals(Object obj)
Map<String,Object>	getDetails() Return the details of the health.
Status	getStatus() Return the status of the health.
int	hashCode()
static Health.Builder	outOfService() Create a new Health.Builder instance with an Status.OUT_OF_SERVICE status.
static Health.Builder	status(Status status) Create a new Health.Builder instance with a specific Status.
static Health.Builder	status(String statusCode) Create a new Health.Builder instance with a specific status code.
String	toString()
static Health.Builder	unknown() Create a new Health.Builder instance with an Status.UNKNOWN status.
static Health.Builder	up() Create a new Health.Builder instance with an Status.UP status.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

getStatus

public Status getStatus()

Return the status of the health.

Specified by:

getStatus in class HealthComponent

Returns:

the status (never null)

getDetails

public Map<String,Object> getDetails()

Return the details of the health.

Returns:

the details (or an empty map)

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

unknown

public static Health.Builder unknown()

Create a new Health.Builder instance with an Status.UNKNOWN status.

Returns:

a new Health.Builder instance

up

public static Health.Builder up()

Create a new Health.Builder instance with an Status.UP status.

Returns:

a new Health.Builder instance

down

public static Health.Builder down(Exception ex)

Create a new Health.Builder instance with an Status.DOWN status and the specified exception details.

Parameters:

ex - the exception

Returns:

a new Health.Builder instance

down

public static Health.Builder down()

Create a new Health.Builder instance with a Status.DOWN status.

Returns:

a new Health.Builder instance

outOfService

public static Health.Builder outOfService()

Create a new Health.Builder instance with an Status.OUT_OF_SERVICE status.

Returns:

a new Health.Builder instance

status

public static Health.Builder status(String statusCode)

Create a new Health.Builder instance with a specific status code.

Parameters:

statusCode - the status code

Returns:

a new Health.Builder instance

status

public static Health.Builder status(Status status)

Create a new Health.Builder instance with a specific Status.

Parameters:

status - the status

Returns:

a new Health.Builder instance