JBoss Server Monitoring

---

Creating a new JBoss monitor

Supported versions of JBoss Server: 3.2.x, 4.x, 4.0.x, 5, 5.1, 6.0, 7.x, Wildfly_8.x

Prerequisites for monitoring JBoss server metrics: Click here

Using the REST API to add a new JBoss monitor: Click here

To create a JBoss server monitor, follow the steps given below:

1. Click on New Monitor link.
2. Select JBoss.
3. Enter the IP Address or hostname of the host where JBoss runs.
4. Choose the JBoss version.
5. Enter the port number for eg., 8080.
6. Check the Is Domain option if the JBoss operating mode is in managed domain. For managed domain, provide the HOST and PORT of domain controller. All the servers in the managed domain is identified and automatically added as monitors. Applications Manager's Wildfly monitoring tool provides this option for version 7.x and above.
   • Enable Filter: Choose this option to filter the addition of monitors for servers in the managed domain.
   • Filter Condition: Select the option include/exclude and provide the filters in the following format:
     HostController1:server1,server2,server3 ; HostController2:server1,server2,server3;...
7. Choose SSL option , if SSL is enabled in JBoss server.
8. Enter the User Name and Password , if JBoss has authentication information.
9. Set the Polling Interval.
10. If you are adding a new monitor from an Admin Server, select a Managed Server.
11. Choose the Monitor Group from the combo box with which you want to associate JBoss Server Monitor (optional). You can choose multiple groups to associate your monitor.
12. Click Add Monitor(s). This discovers JBoss server from the network and starts monitoring them.

For Applications Manager to monitor JBoss, it should be able to access the host where JBoss server runs and vice versa. For more information, refer to online Troubleshooting section.

Monitored Parameters

Performance data is collected by deploying an agent automatically from Applications Manager to the JBoss server that needs to be monitored. Applications Manager's JBoss monitoring tool enables you to monitor the health and performance of your JBoss applications. JBoss servers are monitored based on the attributes such as JVM heap usage, JDBC pool usage, JMS Queue, the different web applications and EJB deployed in the server. The monitoring details of JBoss server are represented graphically that helps to understand the parameters with ease. You can also configure thresholds to the attributes monitored by the server based on these details.

• Availability tab gives the Availability history for the past 24 hours or 30 days.
• Performance tab gives the Health Status and events for the past 24 hours or 30 days.
• List view enables you to perform bulk admin configuration.

Click on the individual monitors listed, to view the following information:

• Overview
• JVM
• Deployments
• Statistics
• JDBC
• Web
• Transactions
• JMS
• Configuration
• Custom attributes

Overview

Parameter	Description
SERVER RESPONSE TIME
Response time	Response time of JBoss server (in ms).

JVM Usage

This metric gives the current amount of free, used and committed memory in the JVM heap in megabytes as well as in percentage.

Parameter	Description
Memory Usage
Type	Type of the memory pool i.e, (Heap memory , Non-Heap Memory, Code cache etc.)
Used Memory in MB	The amount of memory used by the Java Virtual Machine (in MB).
Free Memory in MB	The amount of memory free for the Java Virtual Machine (in MB).
Committed Memory in MB	The amount of memory guaranteed to be available for use by the Java Virtual Machine (in MB).
Total Memory in MB	The total amount of memory allocated for the Java Virtual Machine (in MB).
Used Memory %	The amount of memory used by the Java Virtual Machine (in percentage).
Free Memory %	The amount of memory free for the Java Virtual Machine (in percentage).
JVM USAGE
JVM Heap Size	JVM heap size of JBoss server (in bytes).
Maximum Free Memory (MB)	Maximum amount of free memory available (in MB).
Maximum Free Memory	Maximum amount of free memory available (in percentage).
THREAD USAGE
Live Threads	Number of threads that are currently in use.
Daemon Threads	Number of daemon threads available.
Peak Thread Count	The maximum number of threads in use at any point of time.
Total Threads Started	Total number of threads started.
CLASS LOADING
Class Loaded	The number of classes currently loaded in the Java virtual machine.
Total Class Loaded	The total number of classes loaded since the Java virtual machine has started execution.
Class Unloaded	The number of classes unloaded since the Java virtual machine has started.
Object Pending Finalization	The approximate number of objects for which finalization is pending.

Deployments

Parameter	Description
Deployments
Name	Name of the deployment/war file.
Context	Context name of the web application.
Enabled	Indicates whether the deployment is enabled or not. (true or false)
Runtime Name	Runtime name of the deployment.
Status	The status of the deployment.
Sub-Deployments	The number of sub-deployments.
Servlets	The number of servlets present for the deployment.
Web Applications
Name	Name of the web application.
Context	Context name of the web application.
Active Sessions	Number of sessions currently open/active.
Created Sessions	Number of sessions created.
Expired Sessions	Number of sessions expired.
Rejected Sessions	Number of sessions rejected.
Duplicated Sessions	Number of sessions duplicated.
Session Alive Time (Avg)	The average alive time of sessions (in ms).

Statistics

This tab contains the EJB statistics and Servlet details of the JBoss server. The name, type and module of the EJB along with the number of instance created and removed, instances in passivated state, pooled state, ready state are being captured. The servlet details specify the number of times the servlet was invoked and the execution time for the servlet.

Parameter	Description
EJB Statistics
Name	Name of the EJB appended with the web module name.
EJB	Name of the EJB.
Web Module	Name of the web module.
Type	Type of EJB. (Any one of the following - "Stateless Session Bean", "Stateful Session Bean", "Entity Bean", "Message Driven Bean")
Create count	Number of EJB bean created.
Removed count	Number of EJB bean removed.
Passive count	Total number of beans that have been passivated.
Ready count	The number of bean instances in ready state.
Method ready count	The number of bean methods in ready state.
Pooled count	Number of EJBs available in the pool.
Servlet Details
Name	Name of the servlet appended with web module name.
Servlet	Name of the servlet.
Web module	Name of the web module.
Invocation count	The total number of times the servlet has been invoked since Jboss server was started.
Exec. Time (Total)	The average amount of time (in ms) all invocations of the servlet have executed since it was most recently deployed.
Exec. Time (High)	The average amount of time (in ms) the single longest invocation of the servlet has executed since it was most recently deployed.
Exec. Time (Low)	The average amount of time (in ms) the single shortest invocation of the servlet has executed since it was most recently deployed.
Exec. Time (Avg)	The average amount of time (in milliseconds) it took to execute all invocations of the servlet since it was most recently deployed.
Connections
Name	Name of the session/connection.
Sessions Opened	The global number of sessions opened since last poll.
Sessions Closed	The global number of sessions closed since last poll.
Connections Requested	The global number of connections asked by the sessions since last poll.
Percentage Closed	Percentage of session closed.
Statistics Enabled	Indicates whether statistics are enabled or not. (true or false)
Transactions
Name	Name of the transaction.
Completed	The global number of transactions known to have completed since the statistics were reset.
Successful	The global number of transactions known to have been successful since the statistics were reset.
Successful Transactions	Percentage of successful transactions.
Queries
Name	Name of the query.
Query Put Count	The global number of cacheable queries put in cache since last poll.
Query Hit Count	The global number of cached queries successfully retrieved from cache since last poll.
Query Miss Count	The global number of cached queries not found in cache since last poll.
Query Hit Ratio	The percentage of queries cache hit.
Query Execution Count	The global number of queries executed since last poll.
Max-time taken to execute	The amount of time taken by the slowest recorded query since last poll.
Slow Query	The query that is the slowest.
Second level Cache
Name	Name of the cache.
Put Count	The global number of cacheable entities/collections put in the cache since last poll.
Hit Count	The global number of cacheable entities/collections successfully retrieved from cache since last poll.
Miss Count	The global number of cacheable entities/collections not found in the cache and loaded from the database since last poll.
Hit Ratio	The percentage of second level cache hit.

JDBC

JDBC Connection Pool details are displayed through this metric. The number of connections that are available, active, created, timed out and destroyed are listed. Also available are the metrics pertaining to the prepared statement cache of the database connection in the pools.

Parameter	Description
Pool Usage
Name	Name of the JDBC pool.
Available	The number of available connections in the pool.
Active	The number of active connections. Each of the connections is either in use by an application or available in the pool.
Created	The number of connections created.
Destroyed	The number of connections destroyed.
Wait	The number of requests that had to wait for a connection.
Maximum Used	The maximum number of connections used.
Total Blocking Time(ms)	The total time spent waiting for an exclusive lock on the pool (in milliseconds).
Total Creation Time(ms)	The total time spent creating connections (in milliseconds).
Timed Out	The number of timed out connections.
Idle Time Out in Mins	Amount of time (in minutes) after which unused connections are closed.
Active Connections(%)	The percentage of active connections. Active Connections (%) = (Active / Pool Size) * 100
Maximum Connections Used(%)	The percentage of maximum used connections. Maximum Connections Used(%) = (Max Used / Pool size ) * 100
Prepared Statement Cache
Name	Name of the cache.
Current Size	The number of prepared and callable statements currently cached in the statement cache.
Hit Count	The number of times that statements from the cache were used.
Miss Count	The number of times that a statement request could not be satisfied with a statement from the cache.
Hit Ratio	The percentage of prepared statement cache hit.

Web

Parameter	Description
Web Metrics
Name	Connector name of the global request processor.
Request Count	Number of requests served by this global request processor since last poll.
Error Count	Number of error request received since last poll.
Maximum Time	Maximum time taken by the global request processor to process a request (in ms).
Processing Time	Time taken by this global request processor to process the requests since last poll (in ms).
Bytes Sent Per Second	Average number of bytes sent per second.
Bytes Received Per Second	Average number of bytes received per second.
Requests Failed	Percentage of failed requests.

Transactions

Parameter	Description
TRANSACTIONS
Total	The total number of transactions created, including nested since last poll.
Committed	The number of committed transaction since last poll.
Aborted	The number of aborted transactions since last poll.
TimedOut	The number of transactions that have rolled back due to timeout since last poll.
Nested	The total number of nested transactions created since last poll.
Heuristics	The number of transactions in a heuristic state since last poll.
Inflight	The number of transactions which have begun but not yet terminated since last poll.
Application rollbacks	The number of failed transactions, including timeouts, whose failure origin was an application since last poll.
Resources rollback	The number of failed transactions whose failure origin was a resource since last poll.
Successful commits	Percentage of successful commits. Successful commits = (Committed / Total) * 100
Aborted transactions	Percentage of aborted transactions. Aborted transactions = (Aborted / Total) * 100
TimedOut transactions	Percentage of timedout transactions. Timeout transactions = (Timeout / Total) * 100

JMS

The JMS tab provides an overview of the metrics related to the JMS Queues and Topics. Queues details include metrics like messages in queue, messages added, scheduled, paused along with current delivery percentage. Metrics with respect to topics tracked are message count, messages added, durable and non-durable message count,etc.

Parameter	Description
QUEUES
Name	Name of the queue.
Is paused	Indicates whether the JMS Queue is paused or not.
Messages in Queue	The number of messages currently in this queue.
In Delivery	The number of messages that this queue is currently delivering to its consumers.
Messages Added	The number of messages added to this queue since it was created.
Messages Scheduled	The number of scheduled messages in this queue.
Number of Consumer	The number of consumers consuming messages from this queue.
Currently Delivering	Percentage of message currently delivering. Currently Delivering = (In Delivery / Messages in Queue) * 100.
TOPICS
Name	Name of the topic.
Messages in Topic	The number of messages currently in this topic.
No of Durable Messages	The number of messages for all durable subscribers for this topic.
No of Non-Durable Messages	The number of messages for all non-durable subscribers for this topic.
Subscriptions	The number of durable and non-durable subscribers for this topic.
No of Durable Subscribers	The number of durable subscribers for this topic.
No of Non-Durable Subscribers	The number of non durable subscribers for this topic.
Durable Messages	Percentage of durable messages. Durable Messages = (No of Durable Messages / Messages in Topic) * 100
Non-Durable Messages	Percentage of non-durable messages. Non-Durable Messages = (No of non Durable Messages / Messages in Topic) * 100

Configuration

Parameter	Description
SERVER CONFIGURATION
Launch Type	Launch type of the JBoss server.
Host Name / IP Address	Hostname/IP address on which the JBoss server is running.
Process Type	The process type of JBoss server.
JBoss Version	Version of JBoss running.
Release Codename	Release codename of the JBoss server.
Server State	Current state of the server.
Running Mode	The mode in which the JBoss server is currently running.
Available Processors	Number of processors available for the JBoss server.
Operating System	Operating system on which the JBoss server is running.
Product Name	Name of the JBoss product.
Server Name	Name of the server hosting the JBoss application.
Is Master	Indicates whether the JBoss server is the master or not.
Host Controller Name	Name of the host controller.
Server Group	Name of the server group.

Custom attributes

You can view the custom attributes of the JBoss Server here. Click Add Attributes to add custom MBean attributes and associate MBean actions. For information on adding Custom Monitors, refer to Custom Monitors topic. Below is the detailed list of parameters monitored and the various versions of the server supported: