Red Hat Training

A Red Hat training course is available for Red Hat Fuse

Chapter 14. Tracing messages through routes

Debugging a route usually involves solving one of two problems:
  • a message was improperly transformed
  • a message failed to reach its destination endpoint
Tracing one or more test messages through the route is easiest way to solve these problems.
The route tracing feature of the tooling enables you to monitor the path a message takes through a route and see how the message is transformed as it passes from processor to processor.
Diagram View displays a graphical representation of the route, which enables you to see the path a message takes through it. For each processor in a route, it also displays the average processing time, in milliseconds, for all messages processed since route start-up and the number of messages processed since route start-up.
Messages View displays the messages processed by a JMS destination or route endpoint selected in the Fuse JMX Navigator tree. Selecting an individual message in Messages View, displays the full details and content of the message in the Properties view.
Tracing messages through a route involves the following steps:
  1. Creating test messages for route tracing
  2. Activating route tracing
  3. Tracing messages through a route
  4. Deactivating route tracing

14.1. Creating test messages for route tracing

Overview

Route tracing requires that messages have a specific structure. They must have a message root element in the namespace http://fabric.fusesource.org/schema/messages.

Procedure

To create a test message:
  1. In Project Explorer, right-click the project to open the context menu.
  2. Select New → Fuse Message to open the Fuse Message File wizard.
  3. In the RouteContainer field, enter the path of the folder in which you want to store the message.
    Use the Browse... button to help locate the proper folder.
  4. In the File name field, enter a name for the message.
  5. Click Finish.
    The new message opens in the XML editor.
  6. Fill in the contents (body and header text) of the message.
  7. On the menu bar, click File → Save to save the test message.

Related topics

Section 14.3, “Tracing messages through a route”
New Fuse Message