Version Matrix


Build Status Download

Reactive Circuit Breaker is a library that maintains the state of an upstream resource's health through usage of upstream services rather than using a 'health check' call. Each 'connector' to an upstream service will need to mix in the UsingCircuitBreaker trait and configure its behaviour through implementing all abstract members of the trait. Every function/method that needs circuit breaker protection then wraps the actual function call (that returns a Future) with the withCircuitBreaker method that's available through the mixin.

An upstream service, in the context of the circuit breaker, can be in a number of finite states:

  1. Healthy
  2. Unstable
  3. Unavailable
  4. Trial

The transition between the states is based on the variables supplied to the circuit breaker for a upstream service.

When the circuit breaker for a upstream service is in the Unavailable state, all requests to that service will result in a UnhealthyServiceException returned. Note: In this occurrence, the upstream service is never called.

Circuit Breaker FSM

For configuration details see the scaladoc of this mixin.

##Download reactive-circuit-breaker

resolvers += Resolver.bintrayRepo("hmrc", "releases")

libraryDependencies += "" %% "reactive-circuit-breaker" % "x.x.x"

##Future Enhancements

  • N/A


This code is open source software licensed under the Apache 2.0 License.