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:
-
A list subcommand that specifies a dotted name that is not followed by a wildcard (*) lists the current node’s immediate children. For example, the following subcommand lists all immediate children belonging to the server node:
list --monitor server
-
A list subcommand that specifies a dotted name followed by a wildcard of the form .* lists a hierarchical tree of child nodes from the specified node. For example, the following subcommand lists all children of the applications node, their subsequent child nodes, and so on:
list --monitor server.applications.*
-
A list subcommand that specifies a dotted name preceded or followed by a wildcard of the form *dottedname or dotted * name or dottedname * lists all nodes and their children that match the regular expression created by the specified matching pattern.
-
A get subcommand followed by a .* or a * gets the set of attributes and their values that belong to the node specified.
For example, the following table explains the output of the list and
get subcommands used with the dotted name for the resources node.
Example Resources Level Dotted Names
|
|
|
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.
To 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.
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
Get data for a monitored component or service by using the
get(1)
subcommand.
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
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
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
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.
EJB Cache Monitoring Statistics
|
|
|
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.
EJB Container Monitoring Statistics
|
|
|
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.
EJB Method Monitoring Statistics
|
|
|
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.
EJB Pool Monitoring Statistics
|
|
|
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.
Timer Monitoring Statistics
|
|
|
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.
The HTTP service statistics are described in the following sections:
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.
HTTP Service Virtual Server Monitoring Statistics
|
|
|
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.
Jersey Statistics
|
|
|
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.
Connector Connection Pool Monitoring Statistics (JMS)
|
|
|
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.
Connector Work Management Monitoring Statistics (JMS)
|
|
|
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 Enterprise 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.
JRuby Container Statistics
|
|
|
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.
JRuby Runtime Statistics
|
|
|
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.
JRuby HTTP Service Statistics
|
|
|
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, 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 that are available for class loading in the JVM for
Java SE are shown in the following table.
JVM Monitoring Statistics for Java SE Class Loading
|
|
|
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.
JVM Monitoring Statistics for Java SE - 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. |
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.
JVM Monitoring Statistics for Java SE Compilation
|
|
|
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.
JVM Monitoring Statistics for Java SE Garbage Collectors
|
|
|
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.
JVM Monitoring Statistics for Java SE Memory
|
|
|
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.
JVM Statistics for Java SE Operating System
|
|
|
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.
JVM Monitoring Statistics for Java SE Runtime
|
|
|
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.
Network Keep Alive Statistics
|
|
|
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.
Network Connection Queue Statistics
|
|
|
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.
Network File Cache Statistics
|
|
|
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.
Network Thread Pool Statistics
|
|
|
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.
ORB Monitoring Statistics (Connection Manager)
|
|
|
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.
Resource Monitoring Statistics (Connection Pool)
|
|
|
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.
EJB Security Monitoring Statistics
|
|
|
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.
Web Security Monitoring Statistics
|
|
|
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.
Realm Security Monitoring Statistics
|
|
|
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.
Thread Pool Monitoring Statistics
|
|
|
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.
JVM Monitoring Statistics for Java SE - Thread Info
|
|
|
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.
Transaction Service Monitoring Statistics
|
|
|
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.
Web Module Servlet Statistics
|
|
|
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.
Web JSP Monitoring Statistics
|
|
|
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.
Web Request Monitoring Statistics
|
|
|
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.
Web Servlet Monitoring Statistics
|
|
|
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.
Web Session Monitoring Statistics
|
|
|
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 |
|