The ActiveMatrix Host Microagent enables the monitoring and management of TIBCO ActiveMatrix host and nodes running on each local machine. It provides methods to retrieve node status and host status, as well as control methods to start or stop nodes.
Figure 2 describes the various monitoring points for which execution statistics are available.
This diagram is representative of a typical ActiveMatrix 3.x Application (an Open SOA SCA Assembly). The indicated monitoring points (the arrows in
Figure 2) are the parts of the deployed application for which the ActiveMatrix Service Microagent will provide statistics data.
The Host microagent is also responsible for the lifecycle of the ActiveMatrix Service microagent. The ActiveMatrix Service microagent is designed to monitor services deployed in the ActiveMatrix node and it is integrated with ActiveMatrix Host microagent.
The ActiveMatrix Host microagent creates instances of the Service Microagent for each node (on node start) associated with ActiveMatrix host, and destroys these instances on Node stop.
In order to collect service operation statistics on each node, the Service microagent requires the deployment of an ActiveMatrix 3 Monitoring Application to each node that this microagent is required to monitor.
The Service microagent connects to a node process using Java Attach API. Statistics data can then be retrieved using either synchronous or asynchronous method invocations.
In either approach, the Service microagent connects to the Monitoring Application's JMX MBean to retrieve the service operation statistics data.
The ActiveMatrix 3.2 Monitoring Service application is an ActiveMatrix Application with Java implementation that provides the Service Microagent with access to, or notification of service execution statistics.
The Monitoring Service application provides some configuration capabilities, which can be set in either the TIBCO ActiveMatrix Administrator, or the ActiveMatrix Service Microagent. This monitoring configuration is described in the section
Monitoring Configuration, and in details in the method
changeMonitoringConfig in
Chapter 4, ActiveMatrix Service Microagent.