Skip to content
Endpoint library for the failsafe framework
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
src Added private modifier Jul 3, 2018
.gitignore Refactoring codebase structure Oct 18, 2017
.travis.yml Hard coding codacy url since it makes the build unstable Oct 8, 2018
LICENSE Renamed Packages, Updated license Jul 1, 2016
MAINTAINERS Added myself as a contributor Jul 3, 2018 Added Spring Boot 2.x support (including breaking changes) Jun 27, 2018 Add Jul 13, 2017
pom.xml Bump spring boot version Oct 8, 2018

Codacy Badge Build Status Maven Central

Failsafe Actuator

Failsafe Actuator is a Java library that provides a simple monitoring interface for Spring Boot applications that use the Failsafe library. Using Failsafe Actuator will readily expose the state of your Circuit Breakers (closed, open, half-open) to your Spring Actuator endpoint without additional effort.

Core Technical Concepts/Inspiration

Failsafe Actuator supports Spring's dependency injection to make it easier to use Failsafe. It allows you to monitor the state of your Circuit Breakers so that, whenever a third party that your app relies upon suddenly becomes unavailable, you can discover it immediately and take action. This is essential for applications used in production.

Development Status/Project Roadmap

This library is currently under development and used in production at Zalando.

Find more details about our development plans in the Issues Tracker.

We're always looking for contributors, so if you find an interesting "Help Wanted" issue then please drop us a line in the related issue to claim it and begin working.

Unless you explicitly state otherwise in advance, any non trivial contribution intentionally submitted for inclusion in this project by you to the steward of this repository (Zalando SE, Berlin) shall be under the terms and conditions of the MIT License, without any additional copyright information, terms or conditions.

Getting Started



To use Failsafe Actuator, add the following dependency to your project:





Create your CircuitBreaker by defining them as a Bean.

public class CircuitBreakerConfiguration {
  public CircuitBreaker myBreaker() {
    return new CircuitBreaker();

You can use and configure the created CircuitBreaker by autowiring it in the class where it should be used.

public class MyBean {
    private CircuitBreaker myBreaker;

That's it. By calling the endpoint via http://${yourAddress}/actuator/circuit-breakers. you will get a response which looks like the following:

GET /actuator/circuit-breakers

HTTP/1.1 200
Content-Type: application/json

  "myBreaker": {
    "state": "OPEN"
  "otherBreaker": {
    "state": "CLOSED"

Individual circuit breakers can be requested via /acutuator/circuit-breakers/{name}:

GET /actuator/circuit-breakers/myBreaker

HTTP/1.1 200
Content-Type: application/json

  "state": "OPEN"

You can even modify the circuit breaker state and manually open or close them:

POST /actuator/circuit-breakers/myBreaker
Content-Type: application/json

  "state": "CLOSED"

Example usage

To see a complete example on how to use the library take a look at the Sample Application. It starts a Rest Controller that shows how to autowire CircuitBreaker into your application and configure them.

How to build on your own

In order to build the JAR on your own run the following command:

mvn clean install


This code is released under the MIT license. See License.

You can’t perform that action at this time.