Oracle GlassFish Server 3.0.1 Administration Guide

EJB Statistics

EJBs fit into the tree of objects as shown in Applications Tree Hierarchy. Use the following dotted name pattern to get applications statistics:

server.applications.appname.ejbmodulename.ejbname.bean-cache.statistic

Statistics available for applications are shown in the following sections:

EJB Cache Statistics

Use the following dotted name pattern for EJB cache statistics:

server.applications.appname.ejbmodulename.bean-cache.ejbname.statistic

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

Table 8–5 EJB Cache Monitoring Statistics

Statistic 

Data Type 

Description 

cachemisses

RangeStatistic 

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

cachehits

RangeStatistic 

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

numbeansincache

RangeStatistic 

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. 

EJB Container Statistics

Use the following dotted name pattern for EJB container statistics:

server.applications.appname.ejbmodulename.container.ejbname

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

Table 8–6 EJB Container Monitoring Statistics

Statistic 

Data Type 

Description 

createcount

CountStatistic 

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

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.

pooledcount

RangeStatistic 

Number of entity beans in pooled state. 

readycount

RangeStatistic 

Number of entity beans in ready state. 

removecount

CountStatistic 

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

EJB Method Statistics

Use the following dotted name pattern for EJB method statistics:

server.applications.appname.ejbmodulename.bean-methods.ejbname.statistic

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

Table 8–7 EJB Method Monitoring Statistics

Statistic 

Data Type 

Description 

executiontime

CountStatistic 

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

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. 

EJB Pool Statistics

Use the following dotted name pattern for EJB pool statistics:

server.applications.appname.ejbmodulename.bean-pool.ejbname.statistic

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

Table 8–8 EJB Pool Monitoring Statistics

Statistic 

Data Type 

Description 

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. 

numbeansinpool

RangeStatistic 

Number of EJBs in the associated pool, providing information about how the pool is changing. 

numthreadswaiting

RangeStatistic 

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. 

Timer Statistics

Use the following dotted name pattern for timer statistics:

server.applications.appname.ejbmodulename.timers.ejbname.statistic

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

Table 8–9 Timer Monitoring 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.