JBoss JMX Connectivity Test

Alliance Messaging Hub (AMH) is a modular, financial messaging solution for corporate networks. It allows extensive throughput and sophisticated data management through the use of latest technology to manage messages and files. Swift AMH installation on JBoss server requires Java Management Extensions (JMX) to monitor AMH. For this monitoring to work, the eG agent should be able to connect to JBoss server using JMX port.

This test monitors the JBoss server through JMX and checks if JMX connectivity is available between the eG agent and Swift AMH server, this test also monitors the time taken by AMH server to respond to the request from the agent. These metrics provide valuable insights to the administrators about the connectivity and responsiveness of the node.

Target of the test : A Swift AMH node instance

Agent deploying the test : An internal agent

Outputs of the test : One set of results for JBoss server for each node

Configurable parameters for the test

Parameter

Description

Test period

How often should the test be executed.

Host

The host for which the test is to be configured.

Port

The port at which the specified host listens.

SSL

If the JBoss AS/EAP server being monitored is an SSL-enabled server, then set the SSL flag to Yes. If not, then set the SSL flag to No.

JMX Remote Port

Specify the port at which the JMX listens for requests from remote hosts. Ensure that you specify the same port that you configured in the management.properties file in the <JAVA_HOME>\jre\lib\management folder used by the target application Java Applications chapter.

JNDI Name

Specify the lookup name for connecting to the JMX connector of the Swift AMH.

JMX User, JMX Password and Confirm Password

These parameters appear only if the Measurement Mode is set to jmx. If JMX requires authentication only (but no security), then ensure that the JMX User and JMX Password parameters are configured with the credentials of a user with read-write access to JMX. To know how to create this user, refer to the How to Monitor JBoss Application Server Using eG Enterprise? chapter. Confirm the password by retyping it in the Confirm Password text box.

Measures made by the test

Measurement

Description

Measurement Unit

Interpretation

JMX Availability

Indicates if the connectivity between eG agent and the node is established yet for the current node.

 

The numeric values that correspond to these measure values are as follows:

Measure Value Numeric Value
Established 100
Not Established 0

Note:

By default, this measure reports the Measure Values listed in the table above to indicate the JMX Availability. In the graph of this measure however, the same is indicated using the numeric equivalents only.

Has the PID changed?

Indicates whether/not the process ID that corresponds to the AMH application has changed on the current node.

 

The numeric values that correspond to these measure values are as follows:

Measure Value Numeric Value
No 0
Yes 1

Note:

By default, this measure reports the Measure Values listed in the table above to indicate if the PID has changed. In the graph of this measure however, the same is indicated using the numeric equivalents only.

JMX response time

Indicates the time taken to connect to the JMX agent of the AMH application on the node.

Seconds