Fault Tolerance EIP

This component supports the Circuit Breaker EIP with the MicroProfile Fault Tolerance library.

Camel provides the Circuit Breaker EIP in the route model, which allows to plugin different implementations. MicroProfile Fault Tolerance is one such implementation.

Maven users will need to add the following dependency to their pom.xml to use this EIP:

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-microprofile-fault-tolerance</artifactId>
    <version>x.x.x</version><!-- use the same version as your Camel core version -->
</dependency>

Configuration options

The Fault Tolerance EIP supports 2 options which are listed below:

Name Description Default Type

faultToleranceConfiguration

Configures the Fault Tolerance EIP Use end when configuration is complete, to return back to the Fault Tolerance EIP.

FaultToleranceConfigurationDefinition

faultToleranceConfigurationRef

Refers to a Fault Tolerance configuration to use for configuring the Fault Tolerance EIP.

String

See Fault Tolerance Configuration for all the configuration options on Fault Tolerance Circuit Breaker.

Samples

Below is an example route showing a Fault Tolerance endpoint that protects against a downstream HTTP operation by falling back to the in-lined fallback route.

from("direct:start")
    .circuitBreaker()
        .to("http://fooservice.com/faulty")
    .onFallback()
        .transform().constant("Fallback message")
    .end()
    .to("mock:result");

And in XML DSL:

<camelContext xmlns="http://camel.apache.org/schema/spring">
  <route>
    <from uri="direct:start"/>
    <circuitBreaker>
      <to uri="http://fooservice.com/faulty"/>
      <onFallback>
        <transform>
          <constant>Fallback message</constant>
        </transform>
      </onFallback>
    </circuitBreaker>
    <to uri="mock:result"/>
  </route>
</camelContext>

Configuring Fault Tolerance

You can fine-tune Fault Tolerance by the many Fault Tolerance Configuration options.

For example to use a 2 second execution timeout, you can do as follows:

from("direct:start")
    .circuitBreaker()
        // use 2 second timeout
        .faultToleranceConfiguration().timeoutEnabled(true).timeoutDuration(2000).end()
        .log("Fault Tolerance processing start: ${threadName}")
        .toD("direct:${body}")
        .log("Fault Tolerance processing end: ${threadName}")
    .end()
    .log("After Fault Tolerance ${body}");

And in XML:

<route>
  <from uri="direct:start"/>
  <circuitBreaker>
    <faultToleranceConfiguration timeoutEnabled="true" timeoutDuration="2000"/>
    <log message="Fault Tolerance processing start: ${threadName}"/>
    <toD uri="direct:${body}"/>
    <log message="Fault Tolerance processing end: ${threadName}"/>
  </circuitBreaker>
  <log message="After Fault Tolerance: ${body}"/>
</route>

Fallback

See onFallback.

Using Fault Tolerance with Spring Boot

This component does not support Spring Boot. Instead its support in standalone and with Camel Quarkus.

Camel’s Error Handler and Circuit Breaker EIP

By default the Circuit Breaker EIP handles errors by itself. This means if the circuit breaker is open and the message fails, then Camel’s error handler is not reacting also. However, you can enable Camels error handler with circuit breaker by enabling the inheritErrorHandler option, as shown:

// Camel's error handler that will attempt to redeliver the message 3 times
errorHandler(deadLetterChannel("mock:dead").maximumRedeliveries(3).redeliveryDelay(0));

from("direct:start")
    .to("log:start")
    // turn on Camel's error handler on circuit breaker so Camel can do redeliveries
    .circuitBreaker().inheritErrorHandler(true)
        .to("mock:a")
        .throwException(new IllegalArgumentException("Forced"))
    .end()
    .to("log:result")
    .to("mock:result");

This example is from an unit test, where you can see the Circuit Breaker EIP block has been hardcoded to always fail by throwing an exception. Because the inheritErrorHandler has been enabled, then Camel’s error handler will attempt to call the Circuit Breaker EIP block again.

That means the mock:a endpoint will receive the message again, and a total of 1 + 3 = 4 message (first time + 3 redeliveries).

If we turn off the inheritErrorHandler option (default) then the Circuit Breaker EIP will only be executed once because it handled the error itself.

Back to top