4 JBoss Application Server Metrics

JBoss Application Server is the market-leading, open source Java 2 Enterprise Edition (J2EE) application server, delivering a high-performance and enterprise-class platform for e-business applications. JBoss provides enterprise-class security, transaction support, resource management, load balancing, and clustering.

This chapter provides descriptions for all JBoss Application Server metric categories, and tables list and describe associated metrics for each category.

JBoss Clustering Service Metrics

This category provides metrics about High Availability JNDI (HAJNDI) service of JBoss.

Table 4-1 JBoss Clustering Service Metics

Metric Description

Partition Name

Shows the name of the partition under which JBoss Application Server is running.

Service - Bind Address

Shows the IP address to which the High Availability JNDI (HAJNDI) Service is bound.

Service - Port

Shows the port used by the HAJNDI service.

Service - Rmi Port

Shows the RMI port of the HAJNDI service.

Service - State

Shows the state of the HAJNDI service. Number "3" is for "OK" state.

Service - State (Text)

Shows the state of the HAJNDI service.


JBoss Connection Pools Metrics

This category provides Managed Connection Pool details for JBoss Application Server.

Table 4-2 JBoss Connection Pools Metrics

Metric Description

Criteria

Shows the criteria for managed connection pool for JBoss Application Server.

Maximum Size

Shows the maximum size for managed connection pool for JBoss Application Server.

Minimum Size

Shows the maximum size for managed connection pool for JBoss Application Server.


JBoss DataSource Bind Metrics

This category provides DataSourceBinding service details for JBoss Application Server.

Table 4-3 JBoss DataSource Bind Metrics

Metic Description

JNDI Name

shows the JNDI Name for DataSourceBinding service for JBoss Application Server.


JBoss Ejb Modules Metrics

This category shows the information for the EJB modules that are loaded inside the JBoss Application Server.

Default Collection Interval — Every 15 minutes

Table 4-4 JBoss Ejb Modules Metrics

Metric Description

Name

Shows the name of the EJB module.

Stastistic Provider

This metric shows that the "Statistic Provider" and "State Manageable" attributes are provided to inform a client that the EJB module that is being looked at does or does not support state management, or does or does not provide statistics as defined by the JSR-77 specification.


JBoss Entity Ejb Metrics

This metric category shows information for all the entity EJBs loaded inside the JBoss Application Server.

Default Collection Interval — Every 15 minutes

Table 4-5 JBoss Entity Ejb Metrics

Metric Description

Entity EJB - Current Instances Pooled Count

Shows the number of instance kept in the pool currently.

Entity EJB - Current Ready Instances Count

Shows the number of instance of this EJB are in the ready state.

Entity EJB - Instances Created Count

Shows the count of the instances created for this EJB by the EJB container.

Entity EJB - Instances Removed Count

Shows the number of instance of this EJB that are removed from the EJB container.

Entity EJB - Maximum Instances in the Pool

Shows the maximum number of instance of this EJB that can be put in the pool.

Entity EJB - Maximum Ready Instances Count

shows the maximum number of instance of this EJB that can be in the passive state.

Entity EJB - Minimum Instances in the Pool

Shows the minimum number of instance of this EJB that should be there in the pool.

Entity EJB - Minimum Ready Instances Count

Shows the minimum number of instance of this EJB that should be in the ready state.

Entity EJB - Name

Shows the name of the EJB.

Entity EJB - Parent

Shows the parent or the JAR file to which this EJB belongs.

Statistic Provider

Shows performance statistics support for this managed object (whether true or false).


JBoss JCA Metrics

This metric category gives information for the Java Connector (JCA) resources of the JBoss Application Server.

Default Collection Interval — Every 15 minutes

Table 4-6 JBoss JCA Metrics

Metric Description

JCA - Count Use Time

Shows the current use time (in ms) for JCA Resource.

JCA - Count Use Time (Sec)

Shows the current use time for JCA Resource (in seconds).

JCA - Count Wait Time

Shows the current wait time (in ms) for JCA Resource.

JCA - Current Free Pool Size

Shows the number of instances of this resource in the pool that are not being used currently.

JCA - Current Pool Size

Shows number of instances in the pool currently.

JCA - Current Waiting Thread Count

Shows the number of threads waiting to acquire JCA connections.

JCA - High Pool Size

Shows the High Water mark for JCA Connection pool.

JCA - Instances Close Count

Shows the number of instances closed.

JCA - Instances Created Count

Shows the number of instances created.

JCA - Low Pool Size

Shows the Low Water mark for JCA Connection pool.

JCA - Lower Bound Free Pool Size

Shows the minimum number of instances that can be free inside the pool.

JCA - Lower Bound Pool Size

Shows the lower bound for lower connection pool.

JCA - Max Wait Time

Shows the minimum wait time (in ms) for JCA Resource.

JCA - Maximum Pool Size

Shows the maximum number of instances of this resource that can be there in the pool.

JCA - Maximum Use Time

Shows the maximum usage time for JCA Resource.

JCA - Maximum Waiting Thread Count

Shows the high water mark for waiting thread count for JCA connections.

JCA - Min Wait Time

Shows the minimum wait time (in ms) for JCA Resource.

JCA - Minimum Pool Size

Shows the minimum free pool size.

JCA - Minimum Used Time

Shows the minimum usage time for JCA Resource.

JCA - Minimum Waiting Thread Count

Shows the low water mark for waiting thread count for JCA connections.

JCA - Total Used Time

Shows the total usage time for JCA Resource.

JCA - Total Wait Time

Shows the total wait time for JCA Resource (in ms).

JCA - Upper Bound Free Pool Size

Shows the maximum number of instances that can be free inside the pool.

JCA - Upper Bound Pool Size

Shows the upper bound for JCA Connection Pool.

Name

Shows the name of the JCA resource.

Parent

Shows the name of the resource adaptor to which the JCA resource belongs.

Statistics Provider

Shows performance statistics support for this managed object (whether true or false).


JBoss JVM Metrics

This metric category provides information about the Java Virtual Machine (JVM) on which the JBoss Application Server is running. The upload frequency of this metric is after every sample and the Default Warning Threshold and Default Critical Threshold are 25 and 10 respectively.

Default Collection Interval — Every 30 minutes

Table 4-7 JBoss JVM Metrics

Metric Description

JVM - Free Heap (%)

Shows the percentage of heap memory that is free and is not used by the JVM.

JVM - Heap Size (MB)

Shows the heap memory (in MB) used by the JVM that is used by JBoss Application Server.

JVM Name

Shows the name of the JVM on which JBoss Application Server is running.

JVM Version

Shows the version of the JVM that is used by the JBoss Application Server.

Vendor

Shows the name of the vendor or provider of the JVM.


JBoss Mail Service Metrics

This metric category provides information about the JBoss Mail Service.

Table 4-8 JBoss Mail Service Metrics

Metric Description

Service - Default Sender

Shows the default sender of the any message that goes via JBoss mail service.

Service - JNDI Name

Shows the name by which the JBoss mail service is registered with the JNDI server.

Service - POP3 Server Host

Shows the host of the POP3 server for the JBoss mail service.

Service - SMTP Server Host

Shows the host of the SMTP server for the JBoss mail service.

Service - State

Shows the current state of the JBoss mail service. If the number is 3, then it is up.

Service - State (text)

Shows the state of the JBoss mail service.

Service - Store Protocol

Shows the protocol used by the JBoss mail service for receiving the messages.

Service - Transport Protocol

Shows the transport protocol used by the JBoss mail service for sending messages.


JBoss Message Driven Ejb Metrics

This metric category shows information for all the message driven EJBs loaded inside the JBoss Application Server.

Default Collection Interval — Every 15 minutes

Table 4-9 JBoss Message Driven Ejb Metrics

Metric Description

MDB - Instances Created Count

Shows the count of the instances created for this EJB by the EJB container.

MDB - Instances Removed Count

Shows the number of instance of this EJB that are removed from the EJB container.

MDB - Messages Count

Shows the number of messages received by this EJB.

MDB - Name

Shows name of the EJB.

MDB - Parent

Shows the parent or the jar file to which this EJB belongs.

Statistic Provider

Shows performance statistics support for this managed object (whether true or false).


JBoss Naming Service Metrics

This metric category provides information about the naming service of JBoss Application Server.

Default Collection Interval — Every 15 minutes

Table 4-10 JBoss Naming Service Metrics

Metric Description

Listen Port

Shows the port on which the naming service of JBoss Application Server is running.

RMI Port

Shows the RMI port of the naming service of JBoss Application Server.

Service Name

Shows the name of the service monitored, that is, in this case it is NamingService only.

Service State

Shows the current state of the naming service of JBoss Application Server.


JBoss Protocols Ports Metrics

This category provides connection details for JBoss Application Server.

Table 4-11 JBoss Protocols Ports Metrics

Metric Description

JBoss - Connection Linger Value

Represents linger value on the incoming connection for JBoss Application Server.

JBoss - Connection Timeout

Shows the timeout value on the incoming connection for JBoss Application Server.

JBoss - KeyStore File

Shows the KeyStore file for JBoss Application Server.

KeyStore Type

Shows the configured keystore type for JBoss Application Server.

JBoss - Protocol

Shows the coyote protocol handler in use for JBoss Application Server.

JBoss - Redirect Port

Shows the redirect port for non-SSL to SSL redirects for JBoss Application Server.

JBoss - Redirect Port Protocol

Shows the protocol name for this Connector (http, https) for JBoss Application Server.


JBoss Server Configuration Metrics

This category provides information about the configuration of JBoss Application Server.

Default Collection Interval — Every 30 minutes

Table 4-12 JBoss Server Configuration Metrics

Metric Description

JBoss - Base Directory

Shows the base directory (directory 'server') for the JBoss Application Server.

JBoss - Configuration Name

Shows the name of the configuration that is used by JBoss Application Server. By default, JBoss Application Server comes with some configuration, for example, 'all', 'minimal', and so on.

JBoss - Deployment Filename

Shows the name of the main deployment file of JBoss Application Server. By default, it is jboss-service.xml. The configuration directory contains the "jboss-service.xml" bootstrap descriptor file for a given server configuration. This defines the core service-configurations that are fixed for the lifetime of the server.

JBoss - Home Directory

Shows the installation directory of the JBoss Application Server.

JBoss - Server Home Directory

Shows the configuration directory of JBoss Application Server that is running. If JBoss Application Server is running under 'minimal' configuration, then this metric shows the path to that configuration.


JBoss Server Details Metrics

This category provides server details for JBoss Application Server.

Default Collection Interval — Every 15 minutes

Table 4-13 JBoss Server Details Metrics

Metric Description

Active Thread Count

This metric shows the active thread count for JBoss Application Server.

Active Thread Group Count

This metric shows the active thread group count for JBoss Application Server.

Available No. of Processors

Shows the available number of processors for JBoss Application Server.

Free Heap Size

Shows the free heap memory for JBoss Application Server.

Free Heap Size %

Shows the percentage of available heap memory out of total configured heap memory for JBoss Application Server.

Heap Size

Show the available heap memory (in MB) for JBoss Application Server.

Heap Size (MB)

Shows the available heap memory (in MB) for JBoss Application Server.

Host Name

Provides the host name on which JBoss Application Server is installed.

Java Vendor Name

Provides Java Vendor Name for JBoss Application Server.

Java Version

Shows the version of JDK/JRE for JBoss Application Server.

Java VM Name

Show the name of the Java Virtual Machine (JVM) used for JBoss Application Server.

Java VM Vendor Name

Show the Java VM vendor name with which this JBoss Application Server is running.

Java VM Version

Show the Java VM version with which JBoss Application Server is running.

Maximum Memory

Shows the maximum available memory on which JBoss Application Server is running.

OS Architecture

Provides operating system architecture details on which JBoss Application Server is running.

OS Name

Provides operating system name on which JBoss Application Server is running.

OS Version

Show the operating system version on which JBoss Application Server is running.

Total Heap Size

Shows the total heap memory for JBoss Application Server.

Total Heap Size(MB)

Shows the total heap memory (in MB) for JBoss Application Server.


JBoss Server Metrics

This category provides information about JBoss Application Server.

Default Collection Interval — Every 30 minutes

Table 4-14 JBoss Server Metrics

Metric Description

Host Address

Shows the IP address of the host on which the JBoss Application Serveris running.

Host Name

Shows the host name on which the JBoss Application Server is running.

Host Operating System

Shows the operating system of the host on which the JBoss Application Server is running.

JBoss - Build Date

Shows the build date for the JBoss Application Server.

JBoss - Build ID

Shows the build ID of the JBoss Application Server.

JBoss - Listen Port

Shows the naming service port or Java Naming Provider (JNP) port for the JBoss Application Server.

JBoss - Start Time

Shows date on which the JBoss Application Server was started.

JBoss - Version

Shows the version (build version) of the JBoss Application Server.

JBoss - Version Name

Shows the version name of the JBoss Application Server.


JBoss Servlets Raw Metrics

This metric category provides information for the servlets loaded inside the JBoss Application Server.

Default Collection Interval — Every 15 minutes

Table 4-15 JBoss Servlets Raw Metrics

Metric Description

Parent

Shows the parent or the application to which this servlet belongs.

Servlet - Active Requests / Sec

Shows rate of requests (per sec) on the servlet.

Servlet - Active Requests since last Upload

Shows the current active requests for the servlet.

Servlet - Active Requests, Response Time (Sec)

Shows the response time(per sec) for the servlet for handling those requests.

Servlet - Maximum Response Time

Shows the maximum processing time of a request (depicted by a long value).

Servlet - Minimum Response Time

Shows the minimum processing time of a request (depicted by a long value).

Servlet - Response Time Unit

Shows the unit of time for the requests.

Servlet - Total Requests

Shows the number of requests processed by this servlet.

Servlet - Total Response Time

Shows the average response time for the request.

Servlet Name

Shows the name of the JBoss servlet.

Statistic Description

Shows the description of the statistic instance.

Statistic Name

Shows the name of the statistic instance.

Statistic Provider

Shows the performance statistics support for this managed object (whether true or false).


JBoss Stateful Session EJB Metrics

This category shows information about the stateful EJBs loaded inside the JBoss Application Server.

Default Collection Interval — Every 15 minutes

Table 4-16 JBoss Stateful Session EJB Metrics

Metric Description

Stateful Ejb - Current Method Ready Count

Shows the count of the instances that are in the ready state in the EJB container.

Stateful Ejb - Current Passive Instances Count

Shows the number of instances (of this EJB) that are in the passive state.

Stateful Ejb - Instances Created Count

Shows the count of the instances created for this EJB by the EJB container.

Stateful Ejb - Instances Removed Count

Shows the number of instance of this EJB that are removed from the EJB container.

Stateful Ejb - Maximum Method Ready Count

Shows the maximum number of instances that can be in the ready state in the EJB container.

Stateful Ejb - Maximum Passive Instances Count

Shows the maximum number of instances that can be in the passive state.

Stateful Ejb - Minimum Method Ready Count

Shows the minimum number of instances that can be in the ready state in the EJB container.

Stateful Ejb - Minimum Passive Instances Count

Shows the minimum number of instances that can be in the ready state in the EJB container.

Stateful Ejb - Name

Shows the name of the EJB.

Stateful Ejb - Parent

Shows the parent or the JAR file to which this EJB belongs.

Statistic Provider

Shows performance statistics support for this managed object (whether true or false).


JBoss Stateless Session EJB Metrics

This category shows information about the stateless EJBs loaded inside the jboss server.

Default Collection Interval — Every 15 minutes

Table 4-17 JBoss Stateless Session EJB Metrics

Metric Description

Stateless Ejb - Current Method Ready Count

Shows the count of the instances which are in the ready state in the EJB container.

Stateless Ejb - Instances Created Count

Shows the count of the instances created for this EJB by the EJB container.

Stateless Ejb - Instances Removed Count

Shows the count of the instances removed for this EJB by the EJB container.

Stateless Ejb - Maxinum Method Ready Count

Shows the maximum number of instances that can be in the ready state in the EJB container.

Stateless Ejb - Minimum Method Ready Count

Shows the minimum number of instances that can be in the ready state in the EJB container.

Stateless Ejb - Name

Shows the name of the EJB.

Stateless Ejb - Parent

Shows the parent or the JAR file to which this EJB belongs.

Statistic Provider

Shows performance statistics support for this managed object (whether true or false).


JBoss Top EJBs Metrics

This category shows information for the top performing EJBs of JBoss

Default Collection Interval — Every 15 minutes

Table 4-18 JBoss Top EJBs Metrics

Metric Description

JBoss - Ejb Create Count

Shows the number of instances created for this EJB by the container.

JBoss - Ejb Remove Count

Shows the number of instances removed for this EJB by the container.

JBoss - Ejb Type

Shows the name of the EJB.


JBoss Top Servlets Metrics

This category gives information for the top performing servlets of the JBoss Application Server.

Table 4-19 JBoss Top Servlets Metrics

Metric Description

JBoss - Servlet WAR Name

Shows the parent or application to which the servlet belongs.

JBoss - Web Component Type

Shows the name of the servlet.

Servlet - Active Requests / Sec

Shows rate of request/sec to this servlet.

Servlet - Active Requests since last Upload

Shows number of active requests for this servlet.

Servlet - Active Requests, Response Time (Sec)

Shows the response time in sec for these active requests by the servlet.


JBoss Transactions Metrics

This category shows the information for the transaction manager service of the JBoss Application Server.

Default Collection Interval — Every 15 minutes

Table 4-20 JBoss Transactions Metrics

Metric Description

Committed last interval

Shows the number of transaction committed since last interval.

JBoss - Active Transactions Count

Shows the number of current active transactions.

JBoss - Transactions / Sec

Shows the rate of active transactions per second.

JBoss - Transactions Committed / Sec

Shows the rate of transactions committed per second.

JBoss - Transactions Committed Count

Shows the number of transaction that have been committed.

JBoss - Transactions Rolled Back / Sec

Shows the rate of transactions rolled back per second.

JBoss - Transactions RolledBack Count

Shows the number of transaction that have been rolled back.

JBoss - Transactions Timeout (Secs)

Shows the the time interval in secs after which the transactions will timeout.

Rolledback last interval

Shows the number of transactions rolled back since last interval.

Trans last interval

Shows the transaction that was made since last interval.


JBoss Web Applications Metrics

This category shows performance information about the Web application loaded inside the JBoss Application Server.

Default Collection Interval — Every 15 minutes

Table 4-21 JBoss Web Applications Metrics

Metric Description

Web Apps - Active requests since last agent upload

Shows the current active requests for the application.

Web Apps - Average maximum response time

Shows the average maximum response time for the active requests.

Web Apps - Average minimum response time

Shows the average minimum response time for the active requests.

Web Apps - Average Response Time

Shows the average response given by these applications for the request.

Web Apps - Requests rate per second

Shows the current rate of requests (per sec) to this application.

Web Apps - Total Requests

Shows the total requests for the application.

Web Apps - Total Response Time

Shows the total time take for servicing those requests.

Web Apps - Total Response time for Active Requests

Shows the total response time for all the active requests.


JBoss WebService Service Metrics

This category provides information for the Web services running on the JBoss Application Server.

Table 4-22 JBoss WebService Service Metrics

Metric Description

Service - Bind Address

Shows the IP address to which the Web service is bound.

Service - Host

Shows host name on which the Web service is running.

Service - Port

Shows the port on which the Web service is listening.

Service - State

Shows the state of the Web service as a number. Number "3" depicts that the service is up.

Service - State (text)

Shows the state of the Web service.


Resource Usage Metrics

This category provides metrics related to JBoss Application Server resource usage.

Table 4-23 Resource Usage

Metric Description

Free Memory (%)

Shows the percentage of heap memory that is free and is not used by the Java Virtual Machine (JVM).

Maximum Memory Size (MB)

Provides total heap memory configured for JBoss Application Server.

Memory Usage (MB)

Shows the memory used by JBoss Application Server in MBs.


Response Metrics

This category provides response metrics for JBoss Application Server.

Table 4-24 Response Metrics

Metric Description

UpDown Status

Shows whether the JBoss Application Server is up or down. If the value is 1, then JBoss is up. If the value is 0, then it is down. The upload frequency is after every sample.

If the JBoss Application Server instance is down, then restart it from the scripts that come with JBoss Application Servers.