Oracle GlassFish Server 3.0.1 Administration Guide

Viewing Comprehensive Monitoring Data

By applying the list and get subcommands against the tree structure using dotted names, you can display more comprehensive monitoring data, such as a description of each of the statistics and its unit of measurement.

The following topics are addressed here:

Guidelines for Using the list and get Subcommands for Monitoring

The underlying assumptions for using the list and get subcommands with dotted names are:

For example, the following table explains the output of the list and get subcommands used with the dotted name for the resources node.

Table 8–4 Example Resources Level Dotted Names

Subcommand 

Dotted Name 

Output 

list --monitor

server.resources

List of pool names. 

list --monitor

server.resources.connection-pool1

No attributes, but a message saying “Use get subcommand with the --monitor option to view this node’s attributes and values.”

get --monitor

server.resources.connection-pool1.*

List of attributes and values corresponding to connection pool attributes. 

For detailed information on dotted names, see the dotted-names(5ASC) help page.

ProcedureTo View Comprehensive Monitoring Data

Although the monitor subcommand is useful in many situations, it does not offer the complete list of all monitorable objects. To work with comprehensive data for an object type, use the list --monitor and the get --monitor subcommands followed by the dotted name of a monitorable object.

Before You Begin

A monitorable object must be configured for monitoring before you can display information about the object. See To Enable Monitoring if needed.

  1. List the objects that are enabled for monitoring by using the list(1) subcommand.

    For example, the following subcommand lists all components and services that have monitoring enabled for instance server.


    asadmin> list --monitor "*"
    server.web
    server.connector-service 
    server.orb 
    server.jms-serviceserver.jvm
    server.applications
    server.http-service
    server.thread-pools
  2. Get data for a monitored component or service by using the get(1) subcommand.


Example 8–8 Viewing Attributes for a Specific Type

This example gets information about all the attributes for object type jvm on instance server.


asadmin> get --monitor server.jvm.*
server.jvm.class-loading-system.loadedclasscount = 3715
server.jvm.class-loading-system.totalloadedclasscount = 3731
server.jvm.class-loading-system.unloadedclasscount = 16
server.jvm.compilation-system.name-current = HotSpot Client Compiler
server.jvm.compilation-system.totalcompilationtime = 769
server.jvm.garbage-collectors.Copy.collectioncount = 285
server.jvm.garbage-collectors.Copy.collectiontime = 980
server.jvm.garbage-collectors.MarkSweepCompact.collectioncount = 2
server.jvm.garbage-collectors.MarkSweepCompact.collectiontime = 383
server.jvm.memory.committedheapsize = 23498752
server.jvm.memory.committednonheapsize = 13598720
server.jvm.memory.initheapsize = 0
server.jvm.memory.initnonheapsize = 8585216
server.jvm.memory.maxheapsize = 66650112
server.jvm.memory.maxnonheapsize = 100663296
server.jvm.memory.objectpendingfinalizationcount = 0
server.jvm.memory.usedheapsize = 19741184
server.jvm.memory.usednonheapsize = 13398352
server.jvm.operating-system.arch-current = x86
server.jvm.operating-system.availableprocessors = 2
server.jvm.operating-system.name-current = Windows XP
server.jvm.operating-system.version-current = 5.1
server.jvm.runtime.classpath-current = glassfish.jar
server.jvm.runtime.inputarguments-current = []
server.jvm.runtime.managementspecversion-current = 1.0
server.jvm.runtime.name-current = 4372@ABBAGANI_WORK
server.jvm.runtime.specname-current = Java Virtual Machine Specification
server.jvm.runtime.specvendor-current = Sun Microsystems Inc.
server.jvm.runtime.specversion-current = 1.0
server.jvm.runtime.uptime = 84813
server.jvm.runtime.vmname-current = Java HotSpot(TM) Client VM
server.jvm.runtime.vmvendor-current = Sun Microsystems Inc.
server.jvm.runtime.vmversion-current = 1.5.0_11-b03


Example 8–9 Viewing Monitorable Applications

This example lists all the monitorable applications for instance server.


asadmin> list --monitor server.applications.*
server.applications.app1
server.applications.app2
server.applications.app1.virtual-server1
server.applications.app2.virtual-server1 


Example 8–10 Viewing Attributes for an Application

This example gets information about all the attributes for application hello.


asadmin> get --monitor server.applications.hello.*
server.applications.hello.server.activatedsessionstotal = 0
server.applications.hello.server.activejspsloadedcount = 1
server.applications.hello.server.activeservletsloadedcount = 1
server.applications.hello.server.activesessionscurrent = 1
server.applications.hello.server.activesessionshigh = 1
server.applications.hello.server.errorcount = 0
server.applications.hello.server.expiredsessionstotal = 0
server.applications.hello.server.maxjspsloadedcount = 1
server.applications.hello.server.maxservletsloadedcount = 0
server.applications.hello.server.maxtime = 0
server.applications.hello.server.passivatedsessionstotal = 0
server.applications.hello.server.persistedsessionstotal = 0
server.applications.hello.server.processingtime = 0.0
server.applications.hello.server.rejectedsessionstotal = 0
server.applications.hello.server.requestcount = 0
server.applications.hello.server.sessionstotal = 
server.applications.hello.server.totaljspsloadedcount = 0
server.applications.hello.server.totalservletsloadedcount = 0


Example 8–11 Viewing a Specific Attribute

This example gets information about the jvm attribute runtime.vmversion-current on instance server.


asadmin> get --monitor server.jvm.runtime.vmversion-current
server.jvm.runtime.vmversion-current = 10.0-b23

Comprehensive Monitoring Statistics

You can get comprehensive monitoring statistics by forming a dotted name that specifies the statistic you are looking for. For example, the following dotted name will display the cumulative number of requests for the HTTP service on virtual-server1:

server.http-service.virtual-server1.request.requestcount

The tables in the following sections list the statistics that are available for each monitorable object:

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. 

HTTP Service Statistics

The HTTP service fits into the tree of objects as shown in HTTP Service Tree Hierarchy.

HTTP Service Virtual Server Statistics

Use the following dotted name pattern for HTTP service virtual server statistics:

server.http-service.virtual-server.request.statistic

The HTTP service statistics for virtual servers are shown in the following table.

Table 8–10 HTTP Service Virtual Server Monitoring Statistics

Statistic 

Data Type 

Description 

count200

CountStatistic 

Number of responses with a status code equal to 200 

count2xx

CountStatistic 

Number of responses with a status code in the 2xx range 

count302

CountStatistic 

Number of responses with a status code equal to 302 

count304

CountStatistic 

Number of responses with a status code equal to 304 

count3xx

CountStatistic 

Number of responses with a status code equal in the 3xx range 

count400

CountStatistic 

Number of responses with a status code equal to 400 

count401

CountStatistic 

Number of responses with a status code equal to 401 

count403

CountStatistic 

Number of responses with a status code equal to 403 

count404

CountStatistic 

Number of responses with a status code equal to 404 

count4xx

CountStatistic 

Number of responses with a status code equal in the 4xx range 

count503

CountStatistic 

Number of responses with a status code equal to 503 

count5xx

CountStatistic 

Number of responses with a status code equal in the 5xx range 

countother

CountStatistic 

Number of responses with a status code outside the 2xx, 3xx, 4xx, and 5xx range 

errorcount

CountStatistic 

Cumulative value of the error count, with error count representing the number of cases where the response code was greater than or equal to 400 

hosts

StringStatistic 

The host (alias) names of the virtual server 

maxtime

CountStatistic 

Longest response time for a request; not a cumulative value, but the largest response time from among the response times 

processingtime

CountStatistic 

Cumulative value of the times taken to process each request, with processing time being the average of request processing times over the request count 

requestcount

CountStatistic 

Cumulative number of requests processed so far 

state

StringStatistic 

The state of the virtual server 

Jersey Statistics

Jersey fits into the tree of objects as shown in Applications Tree Hierarchy.

Use the following dotted name pattern for Jersey statistics:

server.applications.jersey-application.jersey.resources.resource-0.hitcount.statistic

The statistics available for Jersey are shown in the following table.

Table 8–11 Jersey Statistics

Statistic 

Data Type 

Description 

resourcehitcount

CountStatistic 

Number of hits on this resource class 

rootresourcehitcount

CountStatistic 

Number of hits on this root resource class 

JMS/Connector Service Statistics

The JMS/Connector Service fits into the tree of objects as shown in JMS/Container Service Tree Hierarchy.

JMS/Connector Service statistics are shown in the following sections:

Connector Connection Pool Statistics (JMS)

Use the following dotted name pattern for JMS/Connector Service connection pool statistics:

server.connector-service.resource-adapter-1.connection-pool.statistic

JMS/Connector Service statistics available for the connector connection pools are shown in the following table.

Table 8–12 Connector Connection Pool Monitoring Statistics (JMS)

Statistic 

Data Type 

Description 

averageconnwaittime

CountStatistic 

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

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. 

numconnfailedvalidation

CountStatistic 

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

numconnused

RangeStatistic 

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

RangeStatistic 

Total number of free connections in the pool as of the last sampling. 

numconntimedout

CountStatistic 

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

numconncreated

CountStatistic 

Number of physical connections, in milliseconds, that were created since the last reset. 

numconndestroyed

CountStatistic 

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

numconnacquired

CountStatistic 

Number of logical connections acquired from the pool. 

numconnreleased

CountStatistic 

Number of logical connections released to the pool. 

waitqueuelenght

CountStatistic 

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

Connector Work Management Statistics (JMS)

Use the following dotted name pattern for JMS/Connector Service work management statistics:

server.connector-service.resource-adapter-1.work-management.statistic

JMS/Connector Service statistics available for connector work management are listed in the following table.

Table 8–13 Connector Work Management Monitoring Statistics (JMS)

Statistic 

Data Type 

Description 

activeworkcount

RangeStatistic 

Number of work objects executed by the connector. 

completedworkcount

CountStatistic 

Number of work objects that were completed. 

rejectedworkcount

CountStatistic 

Number of work objects rejected by the GlassFish Server. 

submittedworkcount

CountStatistic 

Number of work objects submitted by a connector module. 

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. 

JRuby Statistics

JRuby fits into the tree of objects as show in JRuby Tree Hierarchy.

The statistics that are available for JRuby are shown in the following sections:

JRuby Container Statistics

Use the following dotted name pattern for JRuby container statistics:

server.containers.jruby.applications.jruby-application.statistic

The statistics that are available for the JRuby container are shown in the following table.

Table 8–14 JRuby Container Statistics

Statistic 

Data Type 

Description 

environment

StringStatistic 

JRuby application environment 

appname

StringStatistic 

Ruby application name 

contextpath

StringStatistic 

Context path of Ruby application 

jrubyversion

StringStatistic 

JRuby version 

rubyframework

StringStatistic 

Ruby application framework 

JRuby Runtime Statistics

Use the following dotted name pattern for JRuby runtime statistics:

server.containers.jruby.applications.jruby-application.runtime.statistic

The statistics that are available for the JRuby runtime are shown in the following table.

Table 8–15 JRuby Runtime Statistics

Statistic 

Data Type 

Description 

activeruntimes

CountStatistic 

Currently active runtimes 

appname

StringStatistic 

Ruby application name 

hardmaximum

CountStatistic 

Maximum active runtimes 

hardminimum

CountStatistic 

Minimum active runtimes 

JRuby HTTP Service Statistics

Use the following dotted name pattern for JRuby HTTP service statistics:

server.containers.jruby.applications.jruby-application.http.statistic

The statistics that are available for the JRuby HTTP service are shown in the following table.

Table 8–16 JRuby HTTP Service Statistics

Statistic 

Data Type 

Description 

address

StringStatistic 

Server address 

appname

StringStatistic 

Ruby application name 

averageprocessingtime

CountStatistic 

Average request processing time in milliseconds 

contextpath

StringStatistic 

Context path of Ruby application 

count2xx

CountStatistic 

Number of responses with a status code in the 2xx range 

count200

CountStatistic 

Number of responses with a status code equal to 200 

count3xx

CountStatistic 

Number of responses with a status code in the 3xx range 

count302

CountStatistic 

Number of responses with a status code equal to 302 

Count304

CountStatistic 

Number of responses with a status code equal to 304 

count4xx

CountStatistic 

Number of responses with a status code in the 4xx range 

count400

CountStatistic 

Number of responses with a status code equal to 400 

count401

CountStatistic 

Number of responses with a status code equal to 401 

count403

CountStatistic 

Number of responses with a status code equal to 403 

count404

CountStatistic 

Number of responses with a status code equal to 404 

count5xx

CountStatistic 

Number of responses with a status code in the 5xx range 

count503

CountStatistic 

Number of responses with a status code equal to 503 

countother

CountStatistic 

Number of responses with other status codes 

errorcount

CountStatistic 

Number of responses with a status code greater than 400 

requests/seconds

CountStatistic 

Requests per second 

JVM Statistics

The JVM fits into the tree of objects as show in JVM Tree Hierarchy.

The statistics that are available for the Virtual Machine for Java platform (Java Virtual Machine) or JVM machine are shown in the following sections:

JVM Class Loading System Statistics

Use the following dotted name pattern for JVM class loading system statistics:

server.jvm.class-loading-system.statistic

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 about the additional monitoring features for Java SE is available in Monitoring and Management for the Java Platform.

The Java SE monitoring tools are discussed at http://download.oracle.com/docs/cd/E17409_01/javase/6/docs/technotes/tools/.

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

Table 8–17 JVM Monitoring 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 threads in the JVM in Java SE are shown in the following table.

Table 8–18 JVM Monitoring Statistics for Java SE - Threads

Statistic 

Data Type 

Description 

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. 

daemonthreadcount

CountStatistic 

Current number of live daemon threads. 

monitordeadlockedthreads

StringStatistic 

List of thread ids that are monitor deadlocked. 

peakthreadcount

CountStatistic 

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

threadcount

CountStatistic 

Current number of live daemon and non-daemon threads. 

totalstartedthreadcount

CountStatistic 

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

JVM Compilation System Statistics

Use the following dotted name pattern for JVM compilation system statistics:

server.jvm.compilation-system.statistic

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

Table 8–19 JVM Monitoring Statistics for Java SE Compilation

Statistic 

Data Type 

Description 

name-current

StringStatistic 

Name of the current compiler 

totalcompilationtime

CountStatistic 

Accumulated time (in milliseconds) spent in compilation 

JVM Garbage Collectors Statistics

Use the following dotted name pattern for JVM garbage collectors statistics:

server.jvm.garbage-collectors.statistic

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

Table 8–20 JVM Monitoring Statistics for Java SE Garbage Collectors

Statistic 

Data Type 

Description 

collectioncount

CountStatistic 

Total number of collections that have occurred 

collectiontime

CountStatistic 

Accumulated time (in milliseconds) spent in collection 

JVM Memory Statistics

Use the following dotted name pattern for JVM memory statistics:

server.jvm.memory.statistic

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

Table 8–21 JVM Monitoring Statistics for Java SE Memory

Statistic 

Data Type 

Description 

committedheapsize

CountStatistic 

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

committednonheapsize

CountStatistic 

Amount of non-heap memory (in bytes) that is committed for the JVM to use 

initheapsize

CountStatistic 

Size of the heap initially requested by the JVM 

initnonheapsize

CountStatistic 

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

maxheapsize

CountStatistic 

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

maxnonheapsize

CountStatistic 

Maximum amount of non-heap memory (in bytes) that can be used for memory management 

objectpendingfinalizationcount

CountStatistic 

Approximate number of objects that are pending finalization 

usedheapsize

CountStatistic 

Size of the heap currently in use 

usednonheapsize

CountStatistic 

Size of the non-heap area currently in use 

JVM Operating System Statistics

Use the following dotted name pattern for JVM operating system statistics:

server.jvm.operating-system.statistic

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

Table 8–22 JVM Statistics for the Java SE Operating System

Statistic 

Data Type 

Description 

arch-current

StringStatistic 

Operating system architecture 

availableprocessors

CountStatistic 

Number of processors available to the JVM 

name-current

StringStatistic 

Operating system name 

version-current

StringStatistic 

Operating system version 

JVM Runtime Statistics

Use the following dotted name pattern for JVM runtime statistics:

server.jvm.runtime.statistic

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

Table 8–23 JVM Monitoring Statistics for Java SE Runtime

Statistic 

Data Type 

Description 

classpath-current

StringStatistic 

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

inputarguments-current

StringStatistic 

Input arguments passed to the JVM; not including arguments to the main method

managementspecversion-current

StringStatistic 

Management specification version implemented by the JVM 

name-current

StringStatistic 

Name representing the running JVM 

specname-current

StringStatistic 

JVM specification name 

specvendor-current

StringStatistic 

JVM specification vendor 

specversion-current

StringStatistic 

JVM specification version 

uptime

CountStatistic 

Uptime of the JVM (in milliseconds) 

vmname-current

StringStatistic 

JVM implementation name 

vmvendor-current

StringStatistic 

JVM implementation vendor 

vmversion-current

StringStatistic 

JVM implementation version 

Network Statistics

Network fits into the tree of objects as shown in Network Tree Hierarchy.

Network statistics are described in the following sections:

Network Keep Alive Statistics

Use the following dotted name pattern for network keep alive statistics:

server.network.type-of-listener.keep-alive.statistic

Statistics available for network keep alive are shown in the following table.

Table 8–24 Network Keep Alive Statistics

Statistic 

Data Type 

Description 

countconnections

CountStatistic 

Number of connections in keep-alive mode. 

counttimeouts

CountStatistic 

Number of keep-alive connections that timed out. 

secondstimeouts

CountStatistic 

Keep-alive timeout value in seconds. 

maxrequests

CountStatistic 

Maximum number of requests allowed on a single keep-alive connection. 

countflushes

CountStatistic 

Number of keep-alive connections that were closed. 

counthits

CountStatistic 

Number of requests received by connections in keep-alive mode. 

countrefusals

CountStatistic 

Number of keep-alive connections that were rejected. 

Network Connection Queue Statistics

Use the following dotted name pattern for network connection queue statistics:

server.network.type-of-listener.connection-queue.statistic

Statistics available for network connection queue are shown in the following table.

Table 8–25 Network Connection Queue Statistics

Statistic 

Data Type 

Description 

countopenconnections

CountStatistic 

The number of open/active connections 

countoverflows

CountStatistic 

Number of times the queue has been too full to accommodate a connection 

countqueued

CountStatistic 

Number of connections currently in the queue 

countqueued15minutesaverage

CountStatistic 

Average number of connections queued in the last 15 minutes 

countqueued1minuteaverage

CountStatistic 

Average number of connections queued in the last 1 minute 

countqueued5minutesaverage

CountStatistic 

Average number of connections queued in the last 5 minutes 

counttotalconnections

CountStatistic 

Total number of connections that have been accepted 

counttotalqueued

CountStatistic 

Total number of connections that have been queued 

maxqueued

CountStatistic 

Maximum size of the connection queue 

peakqueued

CountStatistic 

Largest number of connections that were in the queue simultaneously 

tickstotalqueued

CountStatistic 

(Unsupported) Total number of ticks that connections have spent in the queue 

Network File Cache Statistics

Use the following dotted name pattern for network file cache statistics:

server.network.type-of-listener.file-cache.statistic

Statistics available for network file cache are shown in the following table.

Table 8–26 Network File Cache Statistics

Statistic 

Data Type 

Description 

contenthits

CountStatistic 

Number of hits on cached file content 

contentmisses

CountStatistic 

Number of misses on cached file content 

heapsize

CountStatistic 

Current cache size in bytes 

hits

CountStatistic 

Number of cache lookup hits 

infohits

CountStatistic 

Number of hits on cached file info 

infomisses

CountStatistic 

Number of misses on cached file info 

mappedmemorysize

CountStatistic 

Size of mapped memory used for caching in bytes 

maxheapsize

CountStatistic 

Maximum heap space used for cache in bytes 

maxmappedmemorysize

CountStatistic 

Maximum memory map size used for caching in bytes 

misses

CountStatistic 

Number of cache lookup misses data type 

opencacheentries

CountStatistic 

Number of current open cache entries 

Network Thread Pool Statistics

Use the following dotted name pattern for network thread pool statistics:

server.network.type-of-listener.thread-pool.statistic

Statistics available for network thread pool are shown in the following table.

Table 8–27 Network Thread Pool Statistics

Statistic 

Data Type 

Description 

corethreads

CountStatistic 

Core number of threads in the thread pool 

currentthreadcount

CountStatistic 

Provides the number of request processing threads currently in the listener thread pool 

currentthreadsbusy

CountStatistic 

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

maxthreads

CountStatistic 

Maximum number of threads allowed in the thread pool 

totalexecutedtasks

CountStatistic 

Provides the total number of tasks, which were executed by the thread pool 

ORB Statistics (Connection Manager)

The ORB fits into the tree of objects as shown in ORB Tree Hierarchy.

Use the following dotted name patterns for ORB statistics:

server.orb.transport.connectioncache.inbound.statistic
server.orb.transport.connectioncache.outbound.statistic

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

Table 8–28 ORB Monitoring Statistics (Connection Manager)

Statistic 

Data Type 

Description 

connectionsidle

CountStatistic 

Total number of connections that are idle to the ORB 

connectionsinuse

CountStatistic 

Total number of connections in use to the ORB 

totalconnections

BoundedRangeStatistic 

Total number of connections to the ORB 

Resource Statistics (Connection Pool)

By monitoring connection pool resources you can measure performance and capture resource usage at runtime. Connections are expensive and frequently cause performance bottlenecks in applications. It is important to monitor how a connection pool is releasing and creating new connections and how many threads are waiting to retrieve a connection from a particular pool.

The connection pool resources fit into the tree of objects as shown in Resources Tree Hierarchy.

Use the following dotted name pattern for connection pool statistics:

server.resources.connection-pool.statistic

The connection pool statistics are shown in the following table.

Table 8–29 Resource Monitoring Statistics (Connection Pool)

Statistic 

Data Type 

Description 

averageconnwaittime

CountStatistic 

Average wait-time-duration per successful connection request 

connrequestwaittime

RangeStatistic 

Longest and shortest wait times, in milliseconds, of connection requests since the last sampling. current value indicates the wait time of the last request that was serviced by the pool 

numconnfailedvalidation

CountStatistic 

Number of connections in the connection pool that failed validation from the start time until the last sampling time 

numconnused

RangeStatistic 

Number of connections that are currently being used, as well as information about the maximum number of connections that were used (high water mark) 

numconnfree

RangeStatistic 

Number of free connections in the pool as of the last sampling 

numconntimedout

CountStatistic 

Number of connections in the pool that timed out between the start time and the last sampling time 

numconncreated

CountStatistic 

Number of physical connections that were created by the pool since the last reset 

numconndestroyed

CountStatistic 

Number of physical connections that were destroyed since the last reset 

numconnacquired

CountStatistic 

Number of logical connections acquired from the pool since the last sampling 

numconnreleased

CountStatistic 

Number of connections released back to the pool since the last sampling 

numconnnotsuccessfullymatched

CountStatistic 

Number of connections rejected during matching 

numconnsuccessfullymatched

CountStatistic 

Number of connections successfully matched 

numpotentialconnleak

CountStatistic 

Number of potential connection leaks 

waitqueuelength

CountStatistic 

Number of connection requests in the queue waiting to be serviced 

Security Statistics

Security fits into the tree of objects as shown in Security Tree Hierarchy.

Statistics available for security are shown in the following sections:

EJB Security Statistics

Use the following dotted name pattern for EJB security statistics:

server.security.ejb.statistic

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

Table 8–30 EJB Security Monitoring Statistics

Statistic 

Data Type 

Description 

policyconfigurationcount

CountStatistic 

Number of policy configuration 

securitymanagercount

CountStatistic 

Number of EJB security managers 

Web Security Statistics

Use the following dotted name pattern for web security statistics:

server.security.web.statistic

The statistics available for web security are listed in the following table.

Table 8–31 Web Security Monitoring Statistics

Statistic 

Data Type 

Description 

websecuritymanagercount

CountStatistic 

Number of security managers 

webpolicyconfigurationcount

CountStatistic 

Number of policy configuration objects 

Realm Security Statistics

Use the following dotted name pattern for realm security statistics:

server.security.realm.statistic

The statistics available for realm security are listed in the following table.

Table 8–32 Realm Security Monitoring Statistics

Statistic 

Data Type 

Description 

realmcount

CountStatistic 

Number of realms 

Thread Pool Statistics

The thread pool fits into the tree of objects as shown in Thread Pool Tree Hierarchy.

The statistics available for thread pools are shown in the following sections:

Thread Pool Monitoring Statistics

Use the following dotted name pattern for thread pool statistics:

server.thread-pool.thread-pool.statistic

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

Table 8–33 Thread Pool Monitoring Statistics

Statistic 

Data Type 

Description 

averagetimeinqueue

BoundedRangeStatistic 

Average amount of time (in milliseconds) a request waited in the queue before being processed 

averageworkcompletiontime

BoundedRangeStatistic 

Average amount of time (in milliseconds) taken to complete an assignment 

currentbusythreads

CountStatistic 

Number of busy threads 

currentnumberofthreads

BoundedRangeStatistic 

Current number of request processing threads 

numberofavailablethreads

CountStatistic 

Number of available threads 

numberofworkitemsinqueue

BoundedRangeStatistic 

Current number of work items waiting in queue 

totalworkitemsadded

CountStatistic 

Total number of work items added to the work queue as of last sampling 

JVM Statistics for Java SE-Thread Information

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

Table 8–34 JVM Monitoring Statistics for Java SE - Thread Info

Statistic 

Data Type 

Description 

blockedcount

CountStatistic 

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

blockedtime

CountStatistic 

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

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. 

threadid

CountStatistic 

ID of the thread. 

threadname

StringStatistic 

Name of the thread. 

threadstate

StringStatistic 

State of the thread. 

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.

Transaction Service Statistics

The transaction service allows the client to freeze the transaction subsystem in order to roll back transactions and determine which transactions are in process at the time of the freeze. The transaction service fits into the tree of objects as shown in Transactions Service Tree Hierarchy.

Use the following dotted name pattern for transaction service statistics:

server.transaction-service.statistic

The statistics available for the transaction service are shown in the following table.

Table 8–35 Transaction Service Monitoring 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. 

Web Statistics

The web module fits into the tree of objects as shown in Web Tree Hierarchy.

The available web statistics shown in the following sections:

Web Module Servlet Statistics

Use the following dotted name pattern for web module servlet statistics:

server.applications.web-module.virtual-server.servlet.statistic
server.applications.application.web-module.virtual-server.servlet.statistic

The available web module servlet statistics are shown in the following table.

Table 8–36 Web Module Servlet Statistics

Statistic 

Data Type 

Description 

errorcount

CountStatistic 

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

maxtime

CountStatistic 

Maximum amount of time the web container waits for requests. 

processingtime

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

CountStatistic 

The total number of requests processed so far. 

servicetime

CountStatistic 

Aggregate response time in milliseconds. 

Web JSP Statistics

Use the following dotted name pattern for web JSP statistics:

server.applications.web-module.virtual-server.statistic
server.applications.application.web-module.virtual-server.statistic

The available web JSP statistics are shown in the following table.

Table 8–37 Web JSP Monitoring Statistics

Statistic 

Data Type 

Description 

jspcount-current

RangeStatistic 

Number of active JSP pages 

jsperrorcount

CountStatistic 

Total number of errors triggered by JSP page invocations 

jspreloadedcount

CountStatistic 

Total number of JSP pages that were reloaded 

totaljspcount

CountStatistic 

Total number of JSP pages ever loaded 

Web Request Statistics

Use the following dotted name pattern for web request statistics:

server.applications.web-module.virtual-server.statistic
server.applications.application.web-module.virtual-server.statistic

The available web request statistics are shown in the following table.

Table 8–38 Web Request Monitoring Statistics

Statistic 

Data Type 

Description 

errorcount

CountStatistic 

Cumulative value of the error count, with error count representing the number of cases where the response code was greater than or equal to 400 

maxtime

CountStatistic 

Longest response time for a request; not a cumulative value, but the largest response time from among the response times 

processingtime

CountStatistic 

Average request processing time, in milliseconds 

requestcount

CountStatistic 

Cumulative number of the requests processed so far 

Web Servlet Statistics

Use the following dotted name pattern for web servlet statistics:

server.applications.web-module.virtual-server.statistic
server.applications.application.web-module.virtual-server.statistic

The available web servlet statistics are shown in the following table.

Table 8–39 Web Servlet Monitoring Statistics

Statistic 

Data Type 

Description 

activeservletsloadedcount

RangeStatistic 

Number of currently loaded servlets 

servletprocessingtimes

CountStatistic 

Cumulative servlet processing times , in milliseconds 

totalservletsloadedcount

CountStatistic 

Cumulative number of servlets that have been loaded into the web module 

Web Session Statistics

Use the following dotted name pattern for web session statistics:

server.applications.web-module.virtual-server.statistic
server.applications.application.web-module.virtual-server.statistic

The available web session statistics are shown in the following table.

Table 8–40 Web Session Monitoring Statistics

Statistic 

Data Type 

Description 

activatedsessionstotal

CountStatistic 

Total number of activated sessions 

activesessionscurrent

RangeStatistic 

Number of currently active sessions 

activesessionshigh

CountStatistic 

Maximum number of concurrently active sessions 

expiredsessionstotal

CountStatistic 

Total number of expired sessions 

passivatedsessionstotal

CountStatistic 

Total number of passivated sessions 

persistedsessionstotal

CountStatistic 

Total number of persisted sessions 

rejectedsessionstotal

CountStatistic 

Total number of rejected sessions 

sessionstotal

CountStatistic 

Total number of sessions created