Sun GlassFish Enterprise Server 2.1 Administration Guide

Statistics for Monitored Components and Services

This section describes the monitoring statistics that are available:

EJB Container Statistics

The EJB container statistics are described in the following tables:

EJB statistics are described in the following table.

Table 18–1 EJB Statistics

Attribute Name 

Data Type 

Description 

createcount

CountStatistic 

Number of times an EJB’s create method is called.

removecount

CountStatistic 

Number of times an EJB’s remove method is called.

pooledcount

RangeStatistic 

Number of entity beans in pooled state. 

readycount

RangeStatistic 

Number of entity beans in ready state. 

messagecount

CountStatistic 

Number of messages received for a message-driven bean. 

methodreadycount

RangeStatistic 

Number of stateful or stateless session beans that are in the MethodReady state.

passivecount

RangeStatistic 

Number of stateful session beans that are in Passive state.

The statistics available for EJB method invocations are listed in the following table.

Table 18–2 EJB Method Statistics

Attribute Name 

Data Type 

Description 

methodstatistic

TimeStatistic 

Number of times an operation is called; the total time that is spent during the invocation, and so on. 

totalnumerrors

CountStatistic 

Number of times the method execution resulted in an exception. This is collected for stateless and stateful session beans and entity beans if monitoring is enabled for the EJB container. 

totalnumsuccess

CountStatistic 

Number of times the method successfully executed. This is collected for stateless and stateful session beans and entity beans if monitoring enabled is true for EJB container. 

executiontime

CountStatistic 

Time (ms) spent executing the method for the last successful/unsuccessful attempt to execute the operation. This is collected for stateless and stateful session beans and entity beans if monitoring is enabled on the EJB container. 

The statistics for EJB Session Stores are listed in the following table.

Table 18–3 EJB Session Store Statistics

Attribute Name 

Data Type 

Description 

currentSize

RangeStatistic 

Number of passivated or checkpointed sessions currently in the store. 

activationCount

CountStatistic 

Number of sessions activated from the store. 

activationSuccessCount

CountStatistic 

Number of sessions successfully activated from the store 

activationErrorCount

CountStatistic 

Time (ms) spent executing the method for the last successful/unsuccessful attempt to execute the operation. This is collected for stateless and stateful session beans and entity beans, if monitoring is enabled on the EJB container. 

passivationCount

CountStatistic 

Number of sessions passivated (inactivated) using this store. 

passivationSuccessCount

CountStatistic 

Number of sessions successfully passivated using this store. 

passivationErrorCount

CountStatistic 

Number of sessions that could not be passivated using this store. 

expiredSessionCount

CountStatistic 

Number of expired sessions that were removed by this store. 

passivatedBeanSize

CountStatistic 

Total number of bytes passivated by this store, including total, minimum, and maximum. 

passivationTime

CountStatistic 

Time spent on passivating beans to the store, including the total, minimum, and maximum. 

checkpointCount (enterprise profile only)

CountStatistic 

Number of sessions checkpointed using this store. 

checkpointSuccessCount (enterprise profile only)

CountStatistic 

Number of sessions checkpointed successfully. 

checkpointErrorCount (enterprise profile only)

CountStatistic 

Number of sessions that couldn't be checkpointed. 

checkpointedBeanSize (enterprise profile only)

ValueStatistic 

Total number of bytes checkpointed by the store. 

checkpointTime enterprise profile only)

TimeStatistic 

Time spent on checkpointing beans to the store. 

The statistics available for EJB pools are listed in the following table.

Table 18–4 EJB Pool Statistics

Attribute Name 

Data Type 

Description 

numbeansinpool

BoundedRangeStatistic 

Number of EJB’s in the associated pool, providing an idea about how the pool is changing. 

numthreadswaiting

BoundedRangeStatistic 

Number of threads waiting for free beans, giving an indication of possible congestion of requests. 

totalbeanscreated

CountStatistic 

Number of beans created in associated pool since the gathering of data started.  

totalbeansdestroyed

CountStatistic 

Number of beans destroyed from associated pool since the gathering of data started. 

jmsmaxmessagesload

CountStatistic 

The maximum number of messages to load into a JMS session at one time for a message-driven bean to serve. Default is 1. Applies only to pools for message driven beans. 

The statistics available for EJB caches are listed in the following table.

Table 18–5 EJB Cache Statistics

Attribute Name 

Data Type 

Description 

cachemisses

BoundedRangeStatistic 

The number of times a user request does not find a bean in the cache. 

cachehits

BoundedRangeStatistic 

The number of times a user request found an entry in the cache. 

numbeansincache

BoundedRangeStatistic 

The number of beans in the cache. This is the current size of the cache. 

numpassivations

CountStatistic 

Number of passivated beans. Applies only to stateful session beans. 

numpassivationerrors

CountStatistic 

Number of errors during passivation. Applies only to stateful session beans. 

numexpiredsessionsremoved

CountStatistic 

Number of expired sessions removed by the cleanup thread. Applies only to stateful session beans. 

numpassivationsuccess

CountStatistic 

Number of times passivation completed successfully. Applies only to stateful session beans. 

The statistics available for Timers are listed in the following table.

Table 18–6 Timer Statistics

Statistic 

Data Type 

Description 

numtimerscreated

CountStatistic 

Number of timers created in the system. 

numtimersdelivered

CountStatistic 

Number of timers delivered by the system. 

numtimersremoved

CountStatistic 

Number of timers removed from the system. 

Web Container Statistics

The web container fits into the tree of objects as shown in The Applications Tree. Web container statistics are displayed for each individual web application. Statistics available for the web container for servlets are shown in Table 18–7, and statistics available for web modules are shown in Table 18–8.

Table 18–7 Web Container (Servlet) Statistics

Statistic 

Units 

Data Type 

Comments 

errorcount

Number 

CountStatistic 

Cumulative number of cases where the response code is greater than or equal to 400. 

maxtime

Milliseconds 

CountStatistic 

The maximum amount of time the web container waits for requests. 

processingtime

Milliseconds 

CountStatistic 

Cumulative value of the amount of time required to process each request. The processing time is the average of request processing times divided by the request count. 

requestcount

Number 

CountStatistic 

The total number of requests processed so far. 

Statistics available for web modules are shown in Web Container Statistics.

Table 18–8 Web Container (Web Module) Statistics

Statistic 

Data Type 

Comments 

jspcount

CountStatistic 

Number of JSP pages that have been loaded in the web module. 

jspreloadcount

CountStatistic 

Number of JSP pages that have been reloaded in the web module. 

sessionstotal

CountStatistic 

Total number of sessions that have been created for the web module. 

activesessionscurrent

CountStatistic 

Number of currently active sessions for the web module. 

activesessionshigh

CountStatistic 

Maximum number of concurrently active sessions for the web module. 

rejectedsessionstotal

CountStatistic 

Total number of rejected sessions for the web module. This is the number of sessions that were not created because the maximum allowed number of sessions were active. 

expiredsessionstotal

CountStatistic 

Total number of expired sessions for the web module. 

sessionsize

AverageRangeStatistic 

Size of the session for the web module. Value is either high, low, or average, or is in bytes for serialized sessions. 

sessionpersisttime

AverageRangeStatistic 

Time (in ms, low, high, or average) taken to persist HTTP session state to back-end store for the web module. 

cachedsessionscurrent

CountStatistic 

Current number of sessions cached in memory for the web module. 

passivatedsessionscurrent

CountStatistic 

Current number of sessions passivated for the web module. 

HTTP Service Statistics

The statistics available for the HTTP service for the developer profile are shown in the following table.

Table 18–9 HTTP Service Statistics (Developer Profile)

Statistic 

Units 

Data Type 

Comments 

bytesreceived

Bytes 

CountStatistic 

The cumulative value of the bytes received by each of the request processors. 

bytessent

Bytes 

CountStatistic 

The cumulative value of the bytes sent by each of the request processors. 

currentthreadcount

Number 

CountStatistic 

The number of processing threads currently in the listener thread pool. 

currentthreadsbusy

Number 

CountStatistic 

The number of request processing threads currently in use in the listener thread pool serving requests. 

errorcount

Number 

CountStatistic 

The cumulative value of the error count, which represents the number of cases where the response code is greater than or equal to 400. 

maxsparethreads

Number 

CountStatistic 

The maximum number of unused response processing threads that can exist. 

minsparethreads

Number 

CountStatistic 

The minimum number of unused response processing threads that can exist. 

maxthreads

Number 

CountStatistic 

The maximum number of request processing threads created by the listener. 

maxtime

Milliseconds 

CountStatistic 

The maximum amount of time for processing threads. 

processing-time

Milliseconds 

CountStatistic 

The cumulative value of the times taken to process each request. The processing time is the average of request processing times divided by the request count. 

request-count

Number 

CountStatistic 

The total number of requests processed so far. 

JDBC Connection Pools Statistics

Monitor JDBC resources to measure performance and capture resource usage at runtime. As the creation of JDBC connections are expensive and frequently cause performance bottlenecks in applications, it is crucial to monitor how a JDBC connection pool is releasing and creating new connections and how many threads are waiting to retrieve a connection from a particular pool.

The statistics available for the JDBC connection pool are shown in the following table.

Table 18–10 JDBC Connection Pool Statistics

Statistic 

Units 

Data Type 

Description 

numconnfailedvalidation

Number 

CountStatistic 

The total number of connections in the connection pool that failed validation from the start time until the last sample time. 

numconnused

Number 

RangeStatistic 

Provides connection usage statistics. The total number of connections that are currently being used, as well as information about the maximum number of connections that were used (the high water mark). 

numconnfree

Number 

CountStatistic 

The total number of free connections in the pool as of the last sampling. 

numconntimedout

Number 

BoundedRangeStatistic 

The total number of connections in the pool that timed out between the start time and the last sample time. 

averageconnwaittime

Number 

CountStatistic 

Indicates the average wait time of connections for successful connection request attempts to the connector connection pool. 

waitqueuelength

Number 

CountStatistic 

Number of connection requests in the queue waiting to be serviced. 

connectionrequestwaittime

 

RangeStatistic 

The longest and shortest wait times of connection requests. The current value indicates the wait time of the last request that was serviced by the pool. 

numconncreated

Milliseconds 

CountStatistic 

The number of physical connections that were created since the last reset. 

numconndestroyed

Number 

CountStatistic 

Number of physical connections that were destroyed since the last reset. 

numconnacquired

Number 

CountStatistic 

Number of logical connections acquired from the pool. 

numconnreleased

Number 

CountStatistic 

Number of logical connections released to the pool. 

JMS/Connector Service Statistics

The statistics available for the connector connection pools are shown in Table 18–11. Statistics for Connector Work Management are shown in Table 18–12.

Table 18–11 Connector Connection Pool Statistics

Statistic 

Units 

Data Type 

Description 

numconnfailedvalidation

Number 

CountStatistic 

The total number of connections in the connection pool that failed validation from the start time until the last sample time. 

numconnused

Number 

RangeStatistic 

Provides connection usage statistics. The total number of connections that are currently being used, as well as information about the maximum number of connections that were used (the high water mark). 

numconnfree

Number 

RangeStatistic 

The total number of free connections in the pool as of the last sampling. 

numconntimedout

Number 

CountStatistic 

The total number of connections in the pool that timed out between the start time and the last sample time. 

averageconnwaittime

Number 

CountStatistic 

Average wait time of connections before they are serviced by the connection pool. 

waitqueuelenght

Number 

CountStatistic 

Number of connection requests in the queue waiting to be serviced. 

connectionrequestwaittime

 

RangeStatistic 

The longest and shortest wait times of connection requests. The current value indicates the wait time of the last request that was serviced by the pool. 

numconncreated

Milliseconds 

CountStatistic 

The number of physical connections that were created since the last reset. 

numconndestroyed

Number 

CountStatistic 

Number of physical connections that were destroyed since the last reset. 

numconnacquired

Number 

CountStatistic 

Number of logical connections acquired from the pool. 

numconnreleased

Number 

CountStatistic 

Number of logical connections released to the pool. 

Statistics available for Connector Work Management are listed in the following table.

Table 18–12 Connector Work Management Statistics

Statistic 

Data Type 

Description 

activeworkcount

RangeStatistic 

Number of work objects executed by the connector. 

waitqueuelength

RangeStatistic 

Number of work objects waiting in the queue before executing. 

workrequestwaittime

RangeStatistic 

Longest and shortest wait of a work object before it gets executed. 

submittedworkcount

CountStatistic 

Number of work objects submitted by a connector module. 

rejectedworkcount

CountStatistic 

Number of work objects rejected by the Enterprise Server. 

completedworkcount

CountStatistic 

Number of work objects that were completed. 

Statistics for Connection Managers in an ORB

The statistics available for the connection manager in an ORB are listed in the following table.

Table 18–13 Connection Manager (in an ORB) Statistics

Statistic 

Units 

Data Type 

Description 

connectionsidle

Number 

CountStatistic 

Provides total number of connections that are idle to the ORB. 

connectionsinuse

Number 

CountStatistic 

Provides total number of connections in use to the ORB. 

totalconnections

Number 

BoundedRangeStatistic 

Total number of connections to the ORB. 

Thread Pools Statistics

The statistics available for the thread pool are shown in the following table.

Table 18–14 Thread Pool Statistics

Statistic 

Units 

Data Type 

Description 

averagetimeinqueue

Milliseconds 

RangeStatistic 

The average amount of time in milliseconds a request waited in the queue before getting processed. 

averageworkcompletion-time

Milliseconds 

RangeStatistic 

The average amount of time taken to complete an assignment, in milliseconds. 

currentnumberofthreads

Number 

BoundedRangeStatistic 

Current number of request processing threads. 

numberofavailablethreads

Number 

CountStatistic 

The number of threads that are available. 

numberofbusythreads

Number 

CountStatistic 

The number of threads that are busy. 

totalworkitemsadded

Number 

CountStatistic 

The total number of work items added so far to the work queue. 

Transaction Service Statistics

The transaction service allows the client to freeze the transaction subsystem in order to roll back transactions and determine the transactions that are in process at the time of the freeze. The statistics available for the transaction service are shown in the following table.

Table 18–15 Transaction Service Statistics

Statistic 

Data Type 

Description 

activecount

CountStatistic 

Number of transactions currently active. 

activeids

StringStatistic 

The ID’s of the transactions that are currently active. Every such transaction can be rolled back after freezing the transaction service. 

committedcount

CountStatistic 

Number of transactions that have been committed. 

rolledbackcount

CountStatistic 

Number of transactions that have been rolled back. 

state

StringStatistic 

Indicates whether or not the transaction has been frozen. 

Java Virtual Machine (JVM) Statistics

The JVM has monitorable attributes that are always enabled. The statistics available for the JVM are shown in the following table.

Table 18–16 JVM Statistics

Statistic 

Data Type 

Description 

heapsize

BoundedRangeStatistic 

The resident memory footprint with the higher and lower bounds of the JVM’s memory heap size. 

uptime

CountStatistic 

The amount of time the JVM has been running. 

JVM Statistics in Java SE

With Java SE, additional monitoring information can be obtained from the JVM. Set the monitoring level to LOW to enable the display of this additional information. Set the monitoring level to HIGH to also view information pertaining to each live thread in the system. More information on the additional monitoring features for Java SE is available in a document titled Monitoring and Management for the Java Platform, which is available from http://java.sun.com/javase/6/docs/technotes/guides/management/.

The Java SE monitoring tools are discussed at http://java.sun.com/javase/6/docs/technotes/tools/#manage.

The statistics available for class loading in the JVM in Java SE are shown in the following table.

Table 18–17 JVM Statistics for Java SE- Class Loading

Statistic 

Data Type 

Description 

loadedclasscount

CountStatistic 

Number of classes that are currently loaded in the JVM. 

totalloadedclasscount

CountStatistic 

Total number of classes that have been loaded since the JVM began execution. 

unloadedclasscount

CountStatistic 

Number of classes that have been unloaded from the JVM since the JVM began execution. 

The statistics available for compilation in the JVM in Java SE are shown in the following table.

Table 18–18 JVM Statistics for Java SE- Compilation

Statistic 

Data Type 

Description 

totalcompilationtime

CountStatistic 

Accumulated time (in milliseconds) spent in compilation. 

The statistics available for garbage collection in the JVM in Java SE are shown in the following table.

Table 18–19 JVM Statistics for Java SE- Garbage Collection

Statistic 

Data Type 

Description 

collectioncount

CountStatistic 

Total number of collections that have occurred. 

collectiontime

CountStatistic 

Accumulated collection time (in milliseconds). 

The statistics available for memory in the JVM in Java SE are shown in the following table.

Table 18–20 JVM Statistics for Java SE- Memory

Statistic 

Data Type 

Description 

objectpendingfinalizationcount

CountStatistic 

Approximate number of objects that are pending finalization. 

initheapsize

CountStatistic 

Size of the heap initially requested by the JVM. 

usedheapsize

CountStatistic 

Size of the heap currently in use. 

maxheapsize

CountStatistic 

Maximum amount of memory (in bytes) that can be used for memory management. 

committedheapsize

CountStatistic 

Amount of memory (in bytes) that is committed for the JVM to use. 

initnonheapsize

CountStatistic 

Size of the non-heap area initially requested by the JVM. 

usednonheapsize

CountStatistic 

Size of the non-heap area currently in use. 

maxnonheapsize

CountStatistic 

Maximum amount of memory (in bytes) that can be used for memory management. 

committednonheapsize

CountStatistic 

Amount of memory (in bytes) that is committed for the JVM to use. 

The statistics available for the operating system in the JVM in Java SE are shown in the following table.

Table 18–21 JVM Statistics for Java SE - Operating System

Statistic 

Data Type 

Description 

arch

StringStatistic 

Operating system architecture. 

availableprocessors

CountStatistic 

Number of processors available to the JVM. 

name

StringStatistic 

Operating system name. 

version

StringStatistic 

Operating system version. 

The statistics available for the runtime in the JVM in Java SE are shown in the following table.

Table 18–22 JVM Statistics for Java SE - Runtime

Statistic 

Data Type 

Description 

name

StringStatistic 

Name representing the running JVM 

vmname

StringStatistic 

JVM implementation name. 

vmvendor

StringStatistic 

JVM implementation vendor. 

vmversion

StringStatistic 

JVM implementation version. 

specname

StringStatistic 

JVM specification name. 

specvendor

StringStatistic 

JVM specification vendor. 

specversion

StringStatistic 

JVM specification version. 

managementspecversion

StringStatistic 

Management spec. version implemented by the JVM. 

classpath

StringStatistic 

Classpath that is used by the system class loader to search for class files. 

librarypath

StringStatistic 

Java library path. 

bootclasspath

StringStatistic 

Classpath that is used by the bootstrap class loader to search for class files. 

inputarguments

StringStatistic 

Input arguments passed to the JVM. Does not include the arguments to the main method.

uptime

CountStatistic 

Uptime of the JVM (in milliseconds). 

The statistics available for ThreadInfo in the JVM in Java SE are shown in the following table.

Table 18–23 JVM Statistics for Java SE - Thread Info

Statistic 

Data Type 

Description 

threadid

CountStatistic 

ID of the thread. 

threadname

StringStatistic 

Name of the thread. 

threadstate

StringStatistic 

State of the thread. 

blockedtime

CountStatistic 

Time elapsed (in milliseconds) since the thread entered the BLOCKED state. Returns -1 if thread contention monitoring is disabled.

blockedcount

CountStatistic 

Total number of times that the thread entered the BLOCKED state.

waitedtime

CountStatistic 

Elapsed time (in milliseconds) that the thread has been in a WAITING state. Returns -1 if thread contention monitoring is disabled.

waitedcount

CountStatistic 

Total number of times the thread was in WAITING or TIMED_WAITING states.

lockname

StringStatistic 

String representation of the monitor lock that the thread is blocked to enter or waiting to be notified through the Object.wait method.

lockownerid

CountStatistic 

ID of the thread that holds the monitor lock of an object on which this thread is blocking. 

lockownername

StringStatistic 

Name of the thread that holds the monitor lock of the object this thread is blocking on. 

stacktrace

StringStatistic 

Stack trace associated with this thread. 

The statistics available for threads in the JVM in Java SE are shown in the following table.

Table 18–24 JVM Statistics for Java SE - Threads

Statistic 

Data Type 

Description 

threadcount

CountStatistic 

Current number of live daemon and non-daemon threads. 

peakthreadcount

CountStatistic 

Peak live thread count since the JVM started or the peak was reset. 

totalstartedthreadcount

CountStatistic 

Total number of threads created and/or started since the JVM started. 

daemonthreadcount

CountStatistic 

Current number of live daemon threads. 

allthreadids

StringStatistic 

List of all live thread ids. 

currentthreadcputime

CountStatistic 

CPU time for the current thread (in nanoseconds) if CPU time measurement is enabled. If CPU time measurement is disabled, returns -1. 

monitordeadlockedthreads

StringStatistic 

List of thread ids that are monitor deadlocked.