Progress Sonic ESB Configuration and Management Guide

Instrumenting SonicMQ
Instrumenting SonicMQ
Progress SonicMQ broker installations include the actional-sdk.jar in the SonicMQ
library archives and the SonicMQ interceptor in the broker.jar.
When a SonicMQ broker is enabled for Actional instrumentation, and both the broker and
agent are running, SonicMQ interceptors are in the flow between the message producers
and message consumers. They intercept all inbound and outbound messages and feed
information about those interactions to the agent as asynchronous events. The SonicMQ
interceptor maps the messaging interactions on an instrumented broker to Actional levels
as follows:
Actional Level Sonic
1 Host Name
2 Sonic Node Name :: Broker Name
3 Destination Name
4 -
A SonicMQ message flow from producer to consumer, when visualized in the Actional
Management Server, might look similar to the following:
Figure 8. SonicMQ Message Flow
where producer P1 published to topic T.1 on broker br3 (a member of Sonic cluster that is
referenced as Sonic routing node A). Subscribers S1and S2 are active consumers on broker
br3 with patterns that include the T.1 topic
Enabling the SonicMQ Interceptor
The SonicMQ Interceptor is installed whenever a SonicMQ broker is installed on a
system. The interceptor is not, by default, enabled. In order to use the Actional Agent to
manage services and processes on a system, you must install and provision the Actional
Agent on the system where the SonicMQ broker runs, and then enable the interceptor by
making configuration changes to the SonicMQ broker, typically through the Sonic
Management Console. Actional integration is set on each broker running on a system.
Progress Sonic ESB Configuration and Management Guide 8.5 270