This section describes the monitoring statistics that are available:
EJB statistics are described in the following table.
Table 16–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 16–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. |
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. |
|
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. |
|
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 16–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 (EE only) |
CountStatistic |
Number of sessions checkpointed using this store. |
checkpointSuccessCount (EE only) |
CountStatistic |
Number of sessions checkpointed successfully. |
checkpointErrorCount (EE only) |
CountStatistic |
Number of sessions that couldn't be checkpointed. |
checkpointedBeanSize (EE only) |
ValueStatistic |
Total number of beans checkpointed by the store. |
checkpointTime (EE only) |
TimeStatistic |
Time spent on checkpointing beans to the store. |
The statistics available for EJB pools are listed in the following table.
Table 16–4 EJB Pool Statistics
Attribute Name |
Data Type |
Description |
---|---|---|
BoundedRangeStatistic |
Number of EJB’s in the associated pool, providing an idea about how the pool is changing. |
|
BoundedRangeStatistic |
Number of threads waiting for free beans, giving an indication of possible congestion of requests. |
|
CountStatistic |
Number of beans created in associated pool since the gathering of data started. |
|
CountStatistic |
Number of beans destroyed from associated pool since the gathering of data started. |
|
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 16–5 EJB Cache Statistics
Attribute Name |
Data Type |
Description |
---|---|---|
BoundedRangeStatistic |
The number of times a user request does not find a bean in the cache. |
|
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. |
CountStatistic |
Number of passivated beans. Applies only to stateful session beans. |
|
CountStatistic |
Number of errors during passivation. Applies only to stateful session beans. |
|
CountStatistic |
Number of expired sessions removed by the cleanup thread. Applies only to stateful session beans. |
|
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 16–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. |
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 Web Container Statistics and statistics available for web modules are shown in Web Container Statistics.
Table 16–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 16–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 (EE only) |
AverageRangeStatistic |
Size of the session for the web module. Value is either high, low, or average, or is in bytes for serialized sessions. |
containerlatency (EE only) |
AverageRangeStatistic |
Latency for the web container’s part of the overall latency request. Value is either high, low, or average. |
sessionpersisttime (EE only) |
AverageRangeStatistic |
Time (in ms, low, high, or average) taken to persist HTTP session state to back-end store for the web module. |
cachedsessionscurrent (EE only) |
CountStatistic |
Current number of sessions cached in memory for the web module. |
passivatedsessionscurrent (EE only) |
CountStatistic |
Current number of sessions passivated for the web module. |
The statistics available for the HTTP service are shown in HTTP Service Statistics. These statistics are applicable to the Platform Edition only.
Table 16–9 HTTP Service Statistics (applicable to Platform Edition only)
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. |
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 16–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 |
RangeStatistic |
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. |
The statistics available for the connector connection pools are shown in JMS/Connector Service Statistics. Statistics for Connector Work Management are shown in JMS/Connector Service Statistics.
Table 16–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 JMS/Connector Service Statistics.
Table 16–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 Application Server. |
completedworkcount |
CountStatistic |
Number of work objects that were completed. |
The statistics available for the connection manager in an ORB are listed in Statistics for Connection Managers in an ORB.
Table 16–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. |
The statistics available for the thread pool are shown in the following table.
Table 16–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. |
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 16–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. |
The JVM has monitorable attributes that are always enabled. The statistics available for the JVM are shown in the following table.
Table 16–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. |
If the Application Server is configured to run on J2SE version 5.0 or higher, 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 available in J2SE 5.0 is available in a document titled Monitoring and Management for the Java Platform, which is available from http://java.sun.com/j2se/1.5.0/docs/guide/management/.
The J2SE 5.0 monitoring tools are discussed at http://java.sun.com/j2se/1.5.0/docs/tooldocs/#manage.
The statistics available for class loading in the JVM in J2SE 5.0 are shown in JVM Statistics in J2SE 5.0.
Table 16–17 JVM Statistics for J2SE 5.0 - 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 J2SE 5.0 are shown in JVM Statistics in J2SE 5.0.
Table 16–18 JVM Statistics for J2SE 5.0 - Compilation
Statistic |
Data Type |
Description |
---|---|---|
totalcompilationtime |
CountStatistic |
Accumulated time (in milliseconds) spent in compilation. |
The statistics available for garbage collection in the JVM in J2SE 5.0 are shown in JVM Statistics in J2SE 5.0.
Table 16–19 JVM Statistics for J2SE 5.0 - 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 J2SE 5.0 are shown in JVM Statistics in J2SE 5.0.
Table 16–20 JVM Statistics for J2SE 5.0 - 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 J2SE 5.0 are shown in JVM Statistics in J2SE 5.0.
Table 16–21 JVM Statistics for J2SE 5.0 - 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 J2SE 5.0 are shown in JVM Statistics in J2SE 5.0.
Table 16–22 JVM Statistics for J2SE 5.0 - 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 J2SE 5.0 are shown in JVM Statistics in J2SE 5.0.
Table 16–23 JVM Statistics for J2SE 5.0 - 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 J2SE 5.0 are shown in JVM Statistics in J2SE 5.0.
Table 16–24 JVM Statistics for J2SE 5.0 - 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. |