Interface BacklogErrorEventMessage

All Superinterfaces:
BacklogEventMessage
public interface BacklogErrorEventMessage extends BacklogEventMessage
Represents an error event captured by the ErrorRegistry.

This extends BacklogEventMessage with error-specific information such as the exception, whether the error was handled by an error handler, the route group, and the message history trace.

Since:
4.21

  • Method Details

    • getRouteGroup

      @Nullable String getRouteGroup()
      The route group of the route where the error occurred, or null if the route has no group assigned.

    • getStepId

      @Nullable String getStepId()
      The id of the Step EIP the exchange was inside when the error occurred, or null if the exchange was not inside a Step EIP.
      Since:
      4.21

    • getFromEndpointUri

      @Nullable String getFromEndpointUri()
      The URI of the route's consumer (from) endpoint where the exchange originated.
      Since:
      4.21

    • getRouteUptime

      long getRouteUptime()
      The uptime of the route (in milliseconds) at the time the error was captured.
      Since:
      4.21

    • getElapsed

      long getElapsed()
      The elapsed processing time of the exchange (in milliseconds) from creation until the error was captured.
      Since:
      4.21

    • getException

      Throwable getException()
      The actual exception that caused the error. This is the live Throwable instance, not a serialized copy.

    • isHandled

      boolean isHandled()
      Whether the error was handled by an error handler (e.g. dead letter channel, onException) so the exchange completed without propagating the exception to the caller. false means the exception was not handled and the exchange failed.

    • getExceptionType

      String getExceptionType()
      The fully qualified class name of the exception (e.g. "java.lang.IllegalArgumentException").

    • getExceptionMessage

      @Nullable String getExceptionMessage()
      The exception's detail message from Throwable.getMessage(), or null if the exception has no message.

    • getMessageHistory

      String @Nullable [] getMessageHistory()
      The message history trace captured at the time of the error, or null if message history is not enabled on the CamelContext.

      Each element represents one step in the routing history in the format "routeId[nodeId] (elapsed ms)".