Since we're on a major migration process of this website, some component documents here are out of sync right now. In the meantime you may want to look at the asciidoc in the repository: https://github.com/apache/camel/blob/master/README.md https://github.com/apache/camel/blob/master/components/readme.adoc
Attaching a Message History to the message will provide a list of all applications that the message passed through since its origination.
When Camel sends a message to an endpoint that endpoint information is stored on the Exchange as a property with the key
Easier Message History
Available as of Camel 2.12
Message History is enabled by default from Camel 2.12. During routing Camel captures how the Exchange is routed, as a
The information can be reached from Java code with:
Enabling or disabling message history
The Message History can be enabled or disabled per
Or from XML DSL with
You can also do this per route. Then a route level configuration overrides the
Route stack-trace in exceptions logged by error handler
If Message History is enabled, then Camel will leverage this information, when the Error Handler logs exhausted exceptions. Then in addition to the caused exception with its stacktrace, you can see the message history; you may think this as a "route stacktrace". And example is provided below:
You can turn off logging message history from the Error Handler using
From Camel 2.17 onwards the Error Handler do not log the message body/header details anymore (to avoid logging sensitive message body details). You can turn on the old behavior.
Using This Pattern
If you would like to use this EIP Pattern then please read the Getting Started, you may also find the Architecture useful particularly the description of Endpoint and URIs. Then you could try out some of the Examples first before trying this pattern out.