Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 1 Introduction : Features of TIBCO Hawk ActiveMatrix Plug-in

Features of TIBCO Hawk ActiveMatrix Plug-in
TIBCO Hawk ActiveMatrix Plug-in consists of the following features.
ActiveMatrix Host Microagent and Service Microagent
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.
The ActiveMatrix Service Microagent provides the following monitoring capabilities:
Monitor execution statistics of service binding(s), reference binding, component services and component references of a deployed ActiveMatrix 3 Application.
Figure 2 describes the various monitoring points for which execution statistics are available.
Figure 2 Monitoring Points for Available Execution Statistics
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.
For details on the metrics provided at each monitoring point, refer to the Service Execution Stats section in Chapter 4, ActiveMatrix Service Microagent.
Monitoring Architecture
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 architecture of the Host and Service microagent and the interaction with the partnering Monitoring Application is shown in Figure 3.
Figure 3 Monitoring Architecture of ActiveMatrix Host and Service Microagents
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.
ActiveMatrix 3.2 Monitoring Service Application
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.
Monitoring Configuration
The monitoring configuration offered by the Monitoring Service application enables the configuration of a rolling window for statistics collection (see Figure 4).
The maximum length of a rolling window is 5 minutes, but this is configurable.
Configuration properties are:
Rolling Window Length - length of rolling window (in seconds, up to 5 minutes)
Statistics gathering interval - length of a bucket (in seconds)
Notification interval - rate at which statistics data is published (via notification)
Is Partial Window - whether to include the current statistics data (incomplete bucket) in notifications.
For example, the configuration settings to produce the diagram (Figure 4) would be:
Figure 4 5 Minute Rolling Window (10 Buckets)
Common Logging Event Publisher Microagent
This microagent publishes events from TIBCO Hawk using the TIBCO Common Logging in the Base Event Format (BEF)/Common Base Event (CBE).
 
 

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved