In Spring-based applications, Spring Integration enables lightweight messaging and supports integration with external systems via declarative adapters.
The App Agent for Java by default automatically discovers exits for all Spring Integration Release 2.2.0 channels except 'DirectChannel.'
See the Sample Application Flow XML below.
AppDynamics Pro Agent for Java supports tracking application flow through Spring Integration messaging channels. The App Agent for Java Spring Integration support is based on the MessageHandler interface.
For pollable channels:
- A continuing transaction is tracked if the Spring Integration framework is polling for messages.
- If the application code polls for messages in a loop, the span of each loop iteration is tracked as a transaction. Tracking begins when the loop begins and end it when the iteration ends.
Originating transactions begin with MessageHandler.handleMessage() implementations. If the incoming message is already recognized by the App Agent for Java then a continuing transaction is started.
Exit points are based on MessageChannel.send(). Most of these message channels are typically inside the JVM so the Application Flow Maps shows a link from the tier to the message channel component name (bean name) and back.
Spring Integration Support Customizations
Track Application Flow Before Message Handler is Executed
In cases where a lot of application flow happens before the first MessageHandler gets executed, you should enable tracking the application flow as follows:
- Find a suitable POJO entry point and configure it.
- Set the enable-spring-integration-entry-points node property to 'false'. This property is set to 'true' by default.
- Restart the application server
Limit Tracking of Looping Pollable Channels
To safeguard against cases where pollableChannel.receive() is not called inside a loop, you can ensure that the App Agent for Java tracks a pollable channel loop only if it happens inside a class/method combination similar to that defined in the following example. Configure the spring-integration-receive-marker-classes node property for each class/method combination that polls messages in a loop, then only those class/methods identified in this node property are tracked.
For example, for the loop above, set the spring-integration-receive-marker-classes node property as follows and restart the application server:
Note: The spring-integration-receive-marker-classes node property must be configured before the method process() gets executed for any changes to take effect. Restart the application server after setting this property.
Sample Application Flow XML
The following XML specifies the integration flow configuration of the application tracked in the image above.
In the following statements, you can see Spring Integration channels that are recognized and identified in the Application Flow Map visualized above: