Use monitoring to observe the runtime state of various components and services deployed in a server instance of theApplication Server. With the information on the state of runtime components and processes, it is possible to identify performance bottlenecks for tuning purposes, aid capacity planning, predict failures, do root cause analysis in case of failures, and ensure that everything is functioning as expected.
Turning monitoring on reduces performance by increasing overhead.
This chapter contains the following sections:
To monitor the Application Server, perform these steps:
Enable the monitoring of specific services and components using either the Administration Console or the asadmin tool.
For more information on this step, refer to Enabling and Disabling Monitoring.
View monitoring data for the specified services or components using either the Administration Console or the asadmin tool.
For more information on this step, refer to Viewing Monitoring Data.
The Application Server uses a tree structure to track monitorable objects. Because the tree of monitoring objects is dynamic, it changes as components are added, updated, or removed in the instance. The root object in the tree is the server instance name, for example, server. (In the Platform Edition, just one server instance is permitted.)
The following command displays the top level of the tree:
asadmin> list --user adminuser --monitor server server.applications server.http-service server.connector-service server.jms-service server.jvm server.orb server.resources server.thread-pools |
The following sections describe these sub-trees:
The following schematic shows the top and child nodes for the various components of enterprise applications. The nodes at which monitoring statistics are available are marked with an asterisk (*). For more information, refer to EJB Container Statistics.
applications |--- application1 | |--- ejb-module-1 | | |--- ejb1 * | | |--- cache (for entity/sfsb) * | | |--- pool (for slsb/mdb/entity) * | | |--- methods | | |---method1 * | | |---method2 * | | |--- stateful-session-store (for sfsb)* | | |--- timers (for s1sb/entity/mdb) * | |--- web-module-1 | | |--- virtual-server-1 * | | |---servlet1 * | | |---servlet2 * |--- standalone-web-module-1 | | |----- virtual-server-2 * | | |---servlet3 * | | |---servlet4 * | | |----- virtual-server-3 * | | |---servlet3 *(same servlet on different vs) | | |---servlet5 * |--- standalone-ejb-module-1 | | |--- ejb2 * | | |--- cache (for entity/sfsb) * | | |--- pool (for slsb/mdb/entity) * | | |--- methods | | |--- method1 * | | |--- method2 * |--- application2
The nodes of the HTTP service are shown in the following schematic. The nodes at which monitoring information is available are marked with an asterisk (*). See HTTP Service Statistics.
http-service |--- virtual-server-1 |--- http-listener-1 * |--- http-listener-2 * |--- virtual-server-2 |--- http-listener-1 * |--- http-listener-2 *
http-service * |---connection-queue * |---dns * |---file-cache * |---keep-alive * |---pwc-thread-pool * |---virtual-server-1* | |--- request * |---virtual-server-2* | |--- request *
The resources node holds monitorable attributes for pools such as the JDBC connection pool and connector connection pool. The following schematic shows the top and child nodes for the various resource components. The nodes at which monitoring statistics are available are marked with an asterisk (*). See JDBC Connection Pools Statistics.
resources |---connection-pool1(either connector-connection-pool or jdbc)* |---connection-pool2(either connector-connection-pool or jdbc)*
The connector services node holds monitorable attributes for pools such as the connector connection pool. The following schematic shows the top and child nodes for the various connector service components. The nodes at which monitoring statistics are available are marked with an asterisk (*). See JMS/Connector Service Statistics.
connector-service |--- resource-adapter-1 | |-- connection-pools | | |-- pool-1 (All pool stats for this pool) | |-- work-management (All work mgmt stats for this RA)
The JMS services node holds monitorable attributes for pools such as the connector connection pool. The following schematic shows the top and child nodes for the various JMS service components. The nodes at which monitoring statistics are available are marked with an asterisk (*).
jms-service |-- connection-factories [AKA conn. pools in the RA world] | |-- connection-factory-1 (All CF stats for this CF) |-- work-management (All work mgmt stats for the MQ-RA)
The ORB node holds monitorable attributes for connection managers. The following schematic shows the top and child nodes for the ORB components. The nodes at which monitoring statistics are available are marked with an asterisk (*). See Statistics for Connection Managers in an ORB.
orb |--- connection-managers | |--- connection-manager-1 * | |--- connection-manager-1 *
The thread pool node holds monitorable attributes for connection managers. The following schematic shows the top and child nodes for the ORB components. The nodes at which monitoring statistics are available are marked with an asterisk (*). See Thread Pools Statistics.
thread-pools | |--- thread-pool-1 * | |--- thread-pool-2 *
This section describes the monitoring statistics that are available:
EJB statistics are described in the following table.
Table 16–1 EJB Statistics
Attribute Name |
Data Type |
Description |
---|---|---|
createcount |
CountStatistic |
Number of times an EJB’s create method is called. |
removecount |
CountStatistic |
Number of times an EJB’s remove method is called. |
pooledcount |
RangeStatistic |
Number of entity beans in pooled state. |
readycount |
RangeStatistic |
Number of entity beans in ready state. |
messagecount |
CountStatistic |
Number of messages received for a message-driven bean. |
methodreadycount |
RangeStatistic |
Number of stateful or stateless session beans that are in the MethodReady state. |
passivecount |
RangeStatistic |
Number of stateful session beans that are in Passive state. |
The statistics available for EJB method invocations are listed in the following table.
Table 16–2 EJB Method Statistics
Attribute Name |
Data Type |
Description |
---|---|---|
methodstatistic |
TimeStatistic |
Number of times an operation is called; the total time that is spent during the invocation, and so on. |
CountStatistic |
Number of times the method execution resulted in an exception. This is collected for stateless and stateful session beans and entity beans if monitoring is enabled for the EJB container. |
|
CountStatistic |
Number of times the method successfully executed. This is collected for stateless and stateful session beans and entity beans if monitoring enabled is true for EJB container. |
|
CountStatistic |
Time (ms) spent executing the method for the last successful/unsuccessful attempt to execute the operation. This is collected for stateless and stateful session beans and entity beans if monitoring is enabled on the EJB container. |
The statistics for EJB Session Stores are listed in the following table.
Table 16–3 EJB Session Store Statistics
Attribute Name |
Data Type |
Description |
---|---|---|
currentSize |
RangeStatistic |
Number of passivated or checkpointed sessions currently in the store. |
activationCount |
CountStatistic |
Number of sessions activated from the store. |
activationSuccessCount |
CountStatistic |
Number of sessions successfully activated from the store |
activationErrorCount |
CountStatistic |
Time (ms) spent executing the method for the last successful/unsuccessful attempt to execute the operation. This is collected for stateless and stateful session beans and entity beans, if monitoring is enabled on the EJB container. |
passivationCount |
CountStatistic |
Number of sessions passivated (inactivated) using this store. |
passivationSuccessCount |
CountStatistic |
Number of sessions successfully passivated using this store. |
passivationErrorCount |
CountStatistic |
Number of sessions that could not be passivated using this store. |
expiredSessionCount |
CountStatistic |
Number of expired sessions that were removed by this store. |
passivatedBeanSize |
CountStatistic |
Total number of bytes passivated by this store, including total, minimum, and maximum. |
passivationTime |
CountStatistic |
Time spent on passivating beans to the store, including the total, minimum, and maximum. |
checkpointCount (EE only) |
CountStatistic |
Number of sessions checkpointed using this store. |
checkpointSuccessCount (EE only) |
CountStatistic |
Number of sessions checkpointed successfully. |
checkpointErrorCount (EE only) |
CountStatistic |
Number of sessions that couldn't be checkpointed. |
checkpointedBeanSize (EE only) |
ValueStatistic |
Total number of beans checkpointed by the store. |
checkpointTime (EE only) |
TimeStatistic |
Time spent on checkpointing beans to the store. |
The statistics available for EJB pools are listed in the following table.
Table 16–4 EJB Pool Statistics
Attribute Name |
Data Type |
Description |
---|---|---|
BoundedRangeStatistic |
Number of EJB’s in the associated pool, providing an idea about how the pool is changing. |
|
BoundedRangeStatistic |
Number of threads waiting for free beans, giving an indication of possible congestion of requests. |
|
CountStatistic |
Number of beans created in associated pool since the gathering of data started. |
|
CountStatistic |
Number of beans destroyed from associated pool since the gathering of data started. |
|
CountStatistic |
The maximum number of messages to load into a JMS session at one time for a message-driven bean to serve. Default is 1. Applies only to pools for message driven beans. |
The statistics available for EJB caches are listed in the following table.
Table 16–5 EJB Cache Statistics
Attribute Name |
Data Type |
Description |
---|---|---|
BoundedRangeStatistic |
The number of times a user request does not find a bean in the cache. |
|
BoundedRangeStatistic |
The number of times a user request found an entry in the cache. |
|
numbeansincache |
BoundedRangeStatistic |
The number of beans in the cache. This is the current size of the cache. |
CountStatistic |
Number of passivated beans. Applies only to stateful session beans. |
|
CountStatistic |
Number of errors during passivation. Applies only to stateful session beans. |
|
CountStatistic |
Number of expired sessions removed by the cleanup thread. Applies only to stateful session beans. |
|
CountStatistic |
Number of times passivation completed successfully. Applies only to stateful session beans. |
The statistics available for Timers are listed in the following table.
Table 16–6 Timer Statistics
Statistic |
Data Type |
Description |
---|---|---|
numtimerscreated |
CountStatistic |
Number of timers created in the system. |
numtimersdelivered |
CountStatistic |
Number of timers delivered by the system. |
numtimersremoved |
CountStatistic |
Number of timers removed from the system. |
The web container fits into the tree of objects as shown in The Applications Tree. Web container statistics are displayed for each individual web application. Statistics available for the web container for Servlets are shown in Web Container Statistics and statistics available for web modules are shown in Web Container Statistics.
Table 16–7 Web Container (Servlet) Statistics
Statistic |
Units |
Data Type |
Comments |
---|---|---|---|
errorcount |
Number |
CountStatistic |
Cumulative number of cases where the response code is greater than or equal to 400. |
maxtime |
Milliseconds |
CountStatistic |
The maximum amount of time the web container waits for requests. |
processingtime |
Milliseconds |
CountStatistic |
Cumulative value of the amount of time required to process each request. The processing time is the average of request processing times divided by the request count. |
requestcount |
Number |
CountStatistic |
The total number of requests processed so far. |
Statistics available for web modules are shown in Web Container Statistics.
Table 16–8 Web Container (Web Module) Statistics
Statistic |
Data Type |
Comments |
---|---|---|
jspcount |
CountStatistic |
Number of JSP pages that have been loaded in the web module. |
jspreloadcount |
CountStatistic |
Number of JSP pages that have been reloaded in the web module. |
sessionstotal |
CountStatistic |
Total number of sessions that have been created for the web module. |
activesessionscurrent |
CountStatistic |
Number of currently active sessions for the web module. |
activesessionshigh |
CountStatistic |
Maximum number of concurrently active sessions for the web module. |
rejectedsessionstotal |
CountStatistic |
Total number of rejected sessions for the web module. This is the number of sessions that were not created because the maximum allowed number of sessions were active. |
expiredsessionstotal |
CountStatistic |
Total number of expired sessions for the web module. |
sessionsize (EE only) |
AverageRangeStatistic |
Size of the session for the web module. Value is either high, low, or average, or is in bytes for serialized sessions. |
containerlatency (EE only) |
AverageRangeStatistic |
Latency for the web container’s part of the overall latency request. Value is either high, low, or average. |
sessionpersisttime (EE only) |
AverageRangeStatistic |
Time (in ms, low, high, or average) taken to persist HTTP session state to back-end store for the web module. |
cachedsessionscurrent (EE only) |
CountStatistic |
Current number of sessions cached in memory for the web module. |
passivatedsessionscurrent (EE only) |
CountStatistic |
Current number of sessions passivated for the web module. |
The statistics available for the HTTP service are shown in HTTP Service Statistics. These statistics are applicable to the Platform Edition only. For statistics for the HTTP Service on the Enterprise Edition, see Production Web Container (PWC) Statistics.
Table 16–9 HTTP Service Statistics (applicable to Platform Edition only)
Statistic |
Units |
Data Type |
Comments |
---|---|---|---|
bytesreceived |
Bytes |
CountStatistic |
The cumulative value of the bytes received by each of the request processors. |
bytessent |
Bytes |
CountStatistic |
The cumulative value of the bytes sent by each of the request processors. |
currentthreadcount |
Number |
CountStatistic |
The number of processing threads currently in the listener thread pool. |
currentthreadsbusy |
Number |
CountStatistic |
The number of request processing threads currently in use in the listener thread pool serving requests. |
errorcount |
Number |
CountStatistic |
The cumulative value of the error count, which represents the number of cases where the response code is greater than or equal to 400. |
maxsparethreads |
Number |
CountStatistic |
The maximum number of unused response processing threads that can exist. |
minsparethreads |
Number |
CountStatistic |
The minimum number of unused response processing threads that can exist. |
maxthreads |
Number |
CountStatistic |
The maximum number of request processing threads created by the listener. |
maxtime |
Milliseconds |
CountStatistic |
The maximum amount of time for processing threads. |
processing-time |
Milliseconds |
CountStatistic |
The cumulative value of the times taken to process each request. The processing time is the average of request processing times divided by the request count. |
request-count |
Number |
CountStatistic |
The total number of requests processed so far. |
Monitor JDBC resources to measure performance and capture resource usage at runtime. As the creation of JDBC connections are expensive and frequently cause performance bottlenecks in applications, it is crucial to monitor how a JDBC connection pool is releasing and creating new connections and how many threads are waiting to retrieve a connection from a particular pool.
The statistics available for the JDBC connection pool are shown in the following table.
Table 16–10 JDBC Connection Pool Statistics
Statistic |
Units |
Data Type |
Description |
---|---|---|---|
numconnfailedvalidation |
Number |
CountStatistic |
The total number of connections in the connection pool that failed validation from the start time until the last sample time. |
numconnused |
Number |
RangeStatistic |
Provides connection usage statistics. The total number of connections that are currently being used, as well as information about the maximum number of connections that were used (the high water mark). |
numconnfree |
Number |
RangeStatistic |
The total number of free connections in the pool as of the last sampling. |
numconntimedout |
Number |
BoundedRangeStatistic |
The total number of connections in the pool that timed out between the start time and the last sample time. |
averageconnwaittime |
Number |
CountStatistic |
Indicates the average wait time of connections for successful connection request attempts to the connector connection pool. |
waitqueuelength |
Number |
CountStatistic |
Number of connection requests in the queue waiting to be serviced. |
connectionrequestwaittime |
RangeStatistic |
The longest and shortest wait times of connection requests. The current value indicates the wait time of the last request that was serviced by the pool. |
|
numconncreated |
Milliseconds |
CountStatistic |
The number of physical connections that were created since the last reset. |
numconndestroyed |
Number |
CountStatistic |
Number of physical connections that were destroyed since the last reset. |
numconnacquired |
Number |
CountStatistic |
Number of logical connections acquired from the pool. |
numconnreleased |
Number |
CountStatistic |
Number of logical connections released to the pool. |
The statistics available for the connector connection pools are shown in JMS/Connector Service Statistics. Statistics for Connector Work Management are shown in JMS/Connector Service Statistics.
Table 16–11 Connector Connection Pool Statistics
Statistic |
Units |
Data Type |
Description |
---|---|---|---|
numconnfailedvalidation |
Number |
CountStatistic |
The total number of connections in the connection pool that failed validation from the start time until the last sample time. |
numconnused |
Number |
RangeStatistic |
Provides connection usage statistics. The total number of connections that are currently being used, as well as information about the maximum number of connections that were used (the high water mark). |
numconnfree |
Number |
RangeStatistic |
The total number of free connections in the pool as of the last sampling. |
numconntimedout |
Number |
CountStatistic |
The total number of connections in the pool that timed out between the start time and the last sample time. |
averageconnwaittime |
Number |
CountStatistic |
Average wait time of connections before they are serviced by the connection pool. |
waitqueuelenght |
Number |
CountStatistic |
Number of connection requests in the queue waiting to be serviced. |
connectionrequestwaittime |
RangeStatistic |
The longest and shortest wait times of connection requests. The current value indicates the wait time of the last request that was serviced by the pool. |
|
numconncreated |
Milliseconds |
CountStatistic |
The number of physical connections that were created since the last reset. |
numconndestroyed |
Number |
CountStatistic |
Number of physical connections that were destroyed since the last reset. |
numconnacquired |
Number |
CountStatistic |
Number of logical connections acquired from the pool. |
numconnreleased |
Number |
CountStatistic |
Number of logical connections released to the pool. |
Statistics available for Connector Work Management are listed in JMS/Connector Service Statistics.
Table 16–12 Connector Work Management Statistics
Statistic |
Data Type |
Description |
---|---|---|
activeworkcount |
RangeStatistic |
Number of work objects executed by the connector. |
waitqueuelength |
RangeStatistic |
Number of work objects waiting in the queue before executing. |
workrequestwaittime |
RangeStatistic |
Longest and shortest wait of a work object before it gets executed. |
submittedworkcount |
CountStatistic |
Number of work objects submitted by a connector module. |
rejectedworkcount |
CountStatistic |
Number of work objects rejected by the Application Server. |
completedworkcount |
CountStatistic |
Number of work objects that were completed. |
The statistics available for the connection manager in an ORB are listed in Statistics for Connection Managers in an ORB.
Table 16–13 Connection Manager (in an ORB) Statistics
Statistic |
Units |
Data Type |
Description |
---|---|---|---|
connectionsidle |
Number |
CountStatistic |
Provides total number of connections that are idle to the ORB. |
connectionsinuse |
Number |
CountStatistic |
Provides total number of connections in use to the ORB. |
totalconnections |
Number |
BoundedRangeStatistic |
Total number of connections to the ORB. |
The statistics available for the thread pool are shown in the following table.
Table 16–14 Thread Pool Statistics
Statistic |
Units |
Data Type |
Description |
---|---|---|---|
averagetimeinqueue |
Milliseconds |
RangeStatistic |
The average amount of time in milliseconds a request waited in the queue before getting processed. |
averageworkcompletion-time |
Milliseconds |
RangeStatistic |
The average amount of time taken to complete an assignment, in milliseconds. |
currentnumberofthreads |
Number |
BoundedRangeStatistic |
Current number of request processing threads. |
numberofavailablethreads |
Number |
CountStatistic |
The number of threads that are available. |
numberofbusythreads |
Number |
CountStatistic |
The number of threads that are busy. |
totalworkitemsadded |
Number |
CountStatistic |
The total number of work items added so far to the work queue. |
The transaction service allows the client to freeze the transaction subsystem in order to roll back transactions and determine the transactions that are in process at the time of the freeze. The statistics available for the transaction service are shown in the following table.
Table 16–15 Transaction Service Statistics
Statistic |
Data Type |
Description |
---|---|---|
activecount |
CountStatistic |
Number of transactions currently active. |
activeids |
StringStatistic |
The ID’s of the transactions that are currently active. Every such transaction can be rolled back after freezing the transaction service. |
committedcount |
CountStatistic |
Number of transactions that have been committed. |
rolledbackcount |
CountStatistic |
Number of transactions that have been rolled back. |
state |
StringStatistic |
Indicates whether or not the transaction has been frozen. |
The JVM has monitorable attributes that are always enabled. The statistics available for the JVM are shown in the following table.
Table 16–16 JVM Statistics
Statistic |
Data Type |
Description |
---|---|---|
heapsize |
BoundedRangeStatistic |
The resident memory footprint with the higher and lower bounds of the JVM’s memory heap size. |
uptime |
CountStatistic |
The amount of time the JVM has been running. |
If the Application Server is configured to run on J2SE version 5.0 or higher, additional monitoring information can be obtained from the JVM. Set the monitoring level to LOW to enable the display of this additional information. Set the monitoring level to HIGH to also view information pertaining to each live thread in the system. More information on the additional monitoring features available in J2SE 5.0 is available in a document titled Monitoring and Management for the Java Platform, which is available from http://java.sun.com/j2se/1.5.0/docs/guide/management/.
The J2SE 5.0 monitoring tools are discussed at http://java.sun.com/j2se/1.5.0/docs/tooldocs/#manage.
The statistics available for class loading in the JVM in J2SE 5.0 are shown in JVM Statistics in J2SE 5.0.
Table 16–17 JVM Statistics for J2SE 5.0 - Class Loading
Statistic |
Data Type |
Description |
---|---|---|
loadedclasscount |
CountStatistic |
Number of classes that are currently loaded in the JVM. |
totalloadedclasscount |
CountStatistic |
Total number of classes that have been loaded since the JVM began execution. |
unloadedclasscount |
CountStatistic |
Number of classes that have been unloaded from the JVM since the JVM began execution. |
The statistics available for compilation in the JVM in J2SE 5.0 are shown in JVM Statistics in J2SE 5.0.
Table 16–18 JVM Statistics for J2SE 5.0 - Compilation
Statistic |
Data Type |
Description |
---|---|---|
totalcompilationtime |
CountStatistic |
Accumulated time (in milliseconds) spent in compilation. |
The statistics available for garbage collection in the JVM in J2SE 5.0 are shown in JVM Statistics in J2SE 5.0.
Table 16–19 JVM Statistics for J2SE 5.0 - Garbage Collection
Statistic |
Data Type |
Description |
---|---|---|
collectioncount |
CountStatistic |
Total number of collections that have occurred. |
collectiontime |
CountStatistic |
Accumulated collection time (in milliseconds). |
The statistics available for memory in the JVM in J2SE 5.0 are shown in JVM Statistics in J2SE 5.0.
Table 16–20 JVM Statistics for J2SE 5.0 - Memory
Statistic |
Data Type |
Description |
---|---|---|
objectpendingfinalizationcount |
CountStatistic |
Approximate number of objects that are pending finalization. |
initheapsize |
CountStatistic |
Size of the heap initially requested by the JVM. |
usedheapsize |
CountStatistic |
Size of the heap currently in use. |
maxheapsize |
CountStatistic |
Maximum amount of memory (in bytes) that can be used for memory management. |
committedheapsize |
CountStatistic |
Amount of memory (in bytes) that is committed for the JVM to use. |
initnonheapsize |
CountStatistic |
Size of the non-heap area initially requested by the JVM. |
usednonheapsize |
CountStatistic |
Size of the non-heap area currently in use. |
maxnonheapsize |
CountStatistic |
Maximum amount of memory (in bytes) that can be used for memory management. |
committednonheapsize |
CountStatistic |
Amount of memory (in bytes) that is committed for the JVM to use. |
The statistics available for the operating system in the JVM in J2SE 5.0 are shown in JVM Statistics in J2SE 5.0.
Table 16–21 JVM Statistics for J2SE 5.0 - Operating System
Statistic |
Data Type |
Description |
---|---|---|
arch |
StringStatistic |
Operating system architecture. |
availableprocessors |
CountStatistic |
Number of processors available to the JVM. |
name |
StringStatistic |
Operating system name. |
version |
StringStatistic |
Operating system version. |
The statistics available for the runtime in the JVM in J2SE 5.0 are shown in JVM Statistics in J2SE 5.0.
Table 16–22 JVM Statistics for J2SE 5.0 - Runtime
Statistic |
Data Type |
Description |
---|---|---|
name |
StringStatistic |
Name representing the running JVM |
vmname |
StringStatistic |
JVM implementation name. |
vmvendor |
StringStatistic |
JVM implementation vendor. |
vmversion |
StringStatistic |
JVM implementation version. |
specname |
StringStatistic |
JVM specification name. |
specvendor |
StringStatistic |
JVM specification vendor. |
specversion |
StringStatistic |
JVM specification version. |
managementspecversion |
StringStatistic |
Management spec. version implemented by the JVM. |
classpath |
StringStatistic |
Classpath that is used by the system class loader to search for class files. |
librarypath |
StringStatistic |
Java library path. |
bootclasspath |
StringStatistic |
Classpath that is used by the bootstrap class loader to search for class files. |
inputarguments |
StringStatistic |
Input arguments passed to the JVM. Does not include the arguments to the main method. |
uptime |
CountStatistic |
Uptime of the JVM (in milliseconds). |
The statistics available for ThreadInfo in the JVM in J2SE 5.0 are shown in JVM Statistics in J2SE 5.0.
Table 16–23 JVM Statistics for J2SE 5.0 - Thread Info
Statistic |
Data Type |
Description |
---|---|---|
threadid |
CountStatistic |
Id of the thread. |
threadname |
StringStatistic |
Name of the thread. |
threadstate |
StringStatistic |
State of the thread. |
blockedtime |
CountStatistic |
Time elapsed (in milliseconds) since the thread entered the BLOCKED state. Returns -1 if thread contention monitoring is disabled. |
blockedcount |
CountStatistic |
Total number of times that the thread entered the BLOCKED state. |
waitedtime |
CountStatistic |
Elapsed time (in milliseconds) that the thread has been in a WAITING state. Returns -1 if thread contention monitoring is disabled. |
waitedcount |
CountStatistic |
Total number of times the thread was in WAITING or TIMED_WAITING states. |
lockname |
StringStatistic |
String representation of the monitor lock that the thread is blocked to enter or waiting to be notified through the Object.wait method. |
lockownerid |
CountStatistic |
Id of the thread that holds the monitor lock of an object on which this thread is blocking. |
lockownername |
StringStatistic |
Name of the thread that holds the monitor lock of the object this thread is blocking on. |
stacktrace |
StringStatistic |
Stack trace associated with this thread. |
The statistics available for threads in the JVM in J2SE 5.0 are shown in JVM Statistics in J2SE 5.0.
Table 16–24 JVM Statistics for J2SE 5.0 - Threads
Statistic |
Data Type |
Description |
---|---|---|
threadcount |
CountStatistic |
Current number of live daemon and non-daemon threads. |
peakthreadcount |
CountStatistic |
Peak live thread count since the JVM started or the peak was reset. |
totalstartedthreadcount |
CountStatistic |
Total number of threads created and/or started since the JVM started. |
daemonthreadcount |
CountStatistic |
Current number of live daemon threads. |
allthreadids |
StringStatistic |
List of all live thread ids. |
currentthreadcputime |
CountStatistic |
CPU time for the current thread (in nanoseconds) if CPU time measurement is enabled. If CPU time measurement is disabled, returns -1. |
monitordeadlockedthreads |
StringStatistic |
List of thread ids that are monitor deadlocked. |
Statistics are available for the following PWC components and services on the Enterprise Edition (EE) of the Application Server:
Production Web Container (PWC) Statistics, PWC Virtual Server
Production Web Container (PWC) Statistics, PWC Request
Production Web Container (PWC) Statistics, PWC File Cache
Production Web Container (PWC) Statistics, PWC Keep Alive
Production Web Container (PWC) Statistics, PWC Thread Pool
Production Web Container (PWC) Statistics, PWC Connection Queue
Production Web Container (PWC) Statistics, PWC HTTP Service
Statistics for PWC virtual servers are listed in Production Web Container (PWC) Statistics.
Table 16–25 PWC Virtual Server Statistics (EE only)
Attribute Name |
Data Type |
Description |
---|---|---|
id |
StringStatistic |
The ID of the virtual server. |
mode |
StringStatistic |
The mode the virtual server is in. Options include unknown or active. |
hosts |
StringStatistic |
Name of the hosts serviced by this virtual server. |
interfaces |
StringStatistic |
Type of interfaces (listeners) for which the virtual server is configured. |
The statistics available for PWC requests are listed in the following table.
Table 16–26 PWC Request Statistics (EE only)
Attribute Name |
Data Type |
Description |
---|---|---|
method |
StringStatistic |
Method used for request. |
uri |
StringStatistic |
Last URI served. |
countrequests |
CountStatistic |
Number of requests served. |
countbytestransmitted |
CountStatistic |
Number of bytes transmitted, or 0 if this information is not available |
countbytesreceived |
CountStatistic |
Number of bytes received, or 0 if this information is not available. |
ratebytesreceived |
CountStatistic |
Rate at which data was received over some server-defined interval, or 0 if this information is not available |
maxbytestransmissionrate |
CountStatistic |
Maximum rate at which data was transmitted over some server-defined interval, or 0 if this information is not available. |
countopenconnections |
CountStatistic |
Number of connections that are currently open, or 0 if this information is not available. |
maxopenconnections |
CountStatistic |
Maximum number of concurrently open connections, or 0 if this information is not available. |
count2xx |
CountStatistic |
Total number of responses of code 2XX. |
count3xx |
CountStatistic |
Total number of responses of code 3XX. |
count4xx |
CountStatistic |
Total number of responses of code 4XX. |
count5xx |
CountStatistic |
Total number of responses of code 5XX. |
countother |
CountStatistic |
Total number of responses with other response codes. |
count200 |
CountStatistic |
Total number of responses of code 200. |
count302 |
CountStatistic |
Total number of responses of code 302. |
count304 |
CountStatistic |
Total number of responses of code 304. |
count400 |
CountStatistic |
Total number of responses of code 400. |
count401 |
CountStatistic |
Total number of responses of code 401. |
count403 |
CountStatistic |
Total number of responses of code 403. |
count404 |
CountStatistic |
Total number of responses of code 404. |
count503 |
CountStatistic |
Total number of responses of code 503. |
The cache information section provides information on how the file cache is being used. Statistics for PWC file caches are listed in the following table.
Table 16–27 PWC File Cache Statistics (EE only)
Attribute Name |
Data Type |
Description |
---|---|---|
flagenabled |
CountStatistic |
Indicates whether the file cache is enabled. Valid values are 0 for no or 1 for yes. |
secondsmaxage |
CountStatistic |
Maximum age of a valid cache entry, in seconds. |
countentries |
CountStatistic |
Number of current cache entries. A single cache entry represents a single URI. |
maxentries |
CountStatistic |
Maximum number of simultaneous cache entries. |
countopenentries |
CountStatistic |
Number of entries associated with an open file. |
maxopenentries |
CountStatistic |
Maximum number of simultaneous cache entries associated with an open file. |
sizeheapcache |
CountStatistic |
Heap space used for cache content. |
maxheapcachesize |
CountStatistic |
Maximum heap space used for cache file content. |
sizemmapcache |
CountStatistic |
Amount of address space used by memory mapped file content. |
maxmmapcachesize |
CountStatistic |
Maximum amount of address space used by the file cache for memory mapped file content. |
counthits |
CountStatistic |
Number of successful cache lookups. |
countmisses |
CountStatistic |
Number of failed cache lookups. |
countinfohits |
CountStatistic |
Number of times a file information lookup succeeded. |
countinfomisses |
CountStatistic |
Number of misses on cached file information. |
countcontenthits |
CountStatistic |
Number of hits on cached file content. |
countcontentmisses |
CountStatistic |
Number of times a file information lookup failed. |
This section provides information about the server's HTTP-level keep-alive system. The statistics available for PWC Keep Alive are listed in the following table.
Table 16–28 PWC Keep Alive Statistics (EE only)
Attribute Name |
Data Type |
Description |
---|---|---|
countconnections |
CountStatistic |
Number of connections in keep-alive mode. |
maxconnections |
CountStatistic |
Maximum number of connections simultaneously allowed in keep-alive mode. |
counthits |
CountStatistic |
The total number of times connections in keep-alive mode have subsequently made a valid request. |
countflushes |
CountStatistic |
The number of times keep-alive connections have been closed by the server. |
countrefusals |
CountStatistic |
The number of times the server could not hand off the connection to a keep-alive thread, possibly due to too many persistent connections. |
counttimeouts |
CountStatistic |
The number of times the server terminated keep-alive connections as the client connections timed out without any activity. |
secondstimeout |
CountStatistic |
The time (in seconds) before idle keep-alive connections are closed. |
The DNS Cache caches IP addresses and DNS names. The server’s DNS cache is disabled by default. A single cache entry represents a singular IP address or DNS name lookup. The statistics available for PWC DNS are listed in the following table.
Table 16–29 PWC DNS Statistics (EE only)
Attribute Name |
Data Type |
Description |
---|---|---|
flagcacheenabled |
CountStatistic |
Indicates whether the DNS cache is enabled (on). Either 0 for off or 1 for on. |
countcacheentries |
CountStatistic |
Number of DNS entries presently in the cache. |
maxcacheentries |
CountStatistic |
Maximum number of DNS entries that can be accommodated by the cache. |
countcachehits |
CountStatistic |
Number of times a DNS cache lookup has succeeded. |
countcachemisses |
CountStatistic |
Number of times a DNS cache lookup has failed. |
flagasyncenabled |
CountStatistic |
Indicates whether asynchronous DNS lookups are enabled (on). Either 0 for off or 1 for on. |
countasyncnamelookups |
CountStatistic |
Total number of asynchronous DNS name lookups. |
countasyncaddrlookups |
CountStatistic |
Total number of asynchronous DNS address lookups. |
countasynclookupsinprogress |
CountStatistic |
Number of asynchronous lookups in progress. |
Statistics for PWC thread pools are listed in the following table.
Table 16–30 PWC Thread Pool Statistics (EE only)
Attribute Name |
Data Type |
Description |
---|---|---|
id |
StringStatistic |
ID of the thread pool. |
countthreadsidle |
CountStatistic |
Number of request-processing threads currently idle. |
countthreads |
CountStatistic |
Current number of request-processing threads. |
maxthreads |
CountStatistic |
Maximum number of request processing threads that can exist concurrently. |
countqueued |
CountStatistic |
Number of requests queued for processing by this thread pool. |
peakqueued |
CountStatistic |
The largest number of requests in the queue simultaneously. |
maxqueued |
CountStatistic |
Maximum number of requests that can be in the queue at one time. |
The Connection Queue is the queue in which requests are held prior to being serviced. Statistics for the connection queue show the number of sessions in the queue and the average delay before the connection is accepted. Statistics for PWC connection queues are listed in the following table.
Table 16–31 PWC Connection Queue Statistics (EE only)
Attribute Name |
Data Type |
Description |
---|---|---|
id |
StringStatistic |
ID of the connection queue. |
counttotalconnections |
CountStatistic |
Total number of connections that have been accepted. |
countqueued |
CountStatistic |
Number of connections currently in the queue. |
peakqueued |
CountStatistic |
Largest number of connections that were in the queue simultaneously. |
maxqueued |
CountStatistic |
Maximum size of the connection queue. |
countoverflows |
CountStatistic |
The number of times the queue has been too full to accommodate a connection. |
counttotalqueued |
CountStatistic |
The total number of connections that have been queued. A given connection may be queued multiple times, so counttotalqueued may be greater than or equal to counttotalconnections. |
tickstotalqueued |
CountStatistic |
The total number of ticks that connections have spent in the queue. A tick is a system-dependent unit of time. |
countqueued1minuteaverage |
CountStatistic |
Average number of connections queued in the last 1 minute. |
countqueued5minuteaverage |
CountStatistic |
Average number of connections queued in the last 5 minutes. |
countqueued15minuteaverage |
CountStatistic |
Average number of connections queued in the last 15 minutes. |
Statistics for PWC HTTP service are listed in the following table.
Table 16–32 PWC HTTP Service Statistics (EE only)
Attribute Name |
Data Type |
Description |
---|---|---|
id |
StringStatistic |
Instance name of the HTTP service. |
versionserver |
StringStatistic |
Version number of the HTTP service. |
timestarted |
StringStatistic |
Time the HTTP service was started (GMT). |
secondsrunning |
CountStatistic |
Time (in seconds) since the HTTP service started. |
maxthreads |
CountStatistic |
Maximum number of worker threads in each instance. |
maxvirtualservers |
CountStatistic |
Maximum number of virtual servers that can be configured in each instance. |
flagprofilingenabled |
CountStatistic |
Whether or not HTTP service performance profiling is enabled. Valid values are 0 or 1. |
flagvirtualserveroverflow |
CountStatistic |
Indicates whether more than maxvirtualservers are configured. If this is set to 1, statistics are not being tracked for all virtual servers. |
load1minuteaverage |
CountStatistic |
Average load for requests in the last 1 minute. |
load5minuteaverage |
CountStatistic |
Average load for requests in the last 5 minutes. |
load15minuteaverage |
CountStatistic |
Average load for requests in the last 15 minutes. |
ratebytestransmitted |
CountStatistic |
The rate at which data is transmitted over some server-defined interval. The result is 0 when this information is not available. |
ratebytesreceived |
CountStatistic |
The rate at which data is received over some server-defined interval. The result is 0 when this information is not available. |
In the Admin Console, you can configure the monitoring levels by selecting the Configurations node > Server instance node >Monitoring Page and choose the value for the services whose monitoring level is changing. By default, monitoring is turned off for all components and services.
For detailed steps on how to configure the monitoring levels, consult the Admin Console online help.
From the command line, use asadmin set to turn ON monitoring for various Application Server components. For example, run the following command to turn on monitoring for the HTTP service:
asadmin> set --user admin-user server.monitoring-service.module-monitoring-levels.http-service=HIGH
Use the get command to find out what services and components currently have monitoring enabled.
asadmin> get --user admin-user server.monitoring-service.module-monitoring-levels.* |
Returns:
server.monitoring-service.module-monitoring-levels. connector-connection-pool = OFF server.monitoring-service.module-monitoring-levels. connector-service = OFF server.monitoring-service.module-monitoring-levels.ejb-container = OFF server.monitoring-service.module-monitoring-levels.http-service = HIGH server.monitoring-service.module-monitoring-levels.jdbc-connection-pool = OFF server.monitoring-service.module-monitoring-levels.jms-service = OFF server.monitoring-service.module-monitoring-levels.jvm = OFF server.monitoring-service.module-monitoring-levels.orb = OFF server.monitoring-service.module-monitoring-levels.thread-pool = OFF server.monitoring-service.module-monitoring-levels.transaction-service = OFF server.monitoring-service.module-monitoring-levels.web-container = OFF |
Use the set command to turn OFF monitoring.
For example, run the following command to disable monitoring for the HTTP service:
asadmin> set --user admin-user server.monitoring-service.module-monitoring-levels.http-service=OFF |
Similarly, to disable monitoring for other components, use the set command and specify OFF for the monitoring level.
In the Admin Console, you can view monitoring data by navigating to the Monitoring page for the standalone server instance and selecting the component or service that has been deployed onto the server instance for which monitoring is enabled. The monitoring data for the selected component or service displays below the View field. For a description of the monitorable properties.
Use the Administration Console to monitor remote applications and instances. For this to occur, the remote instance must be running and the configuration set. For detailed steps on viewing the monitoring data, consult the Admin Console online help.
To view monitoring data using command line utility, use the asadmin list and asadmin get commands followed by the dotted name of a monitorable object, as follows:
To view the names of the objects that can be monitored, use the asadmin list command.
For example, to view a list of application components and subsystems that have monitoring enabled for the server instance, type the following command in a terminal window:
asadmin> list --user adminuser --monitor server |
The preceding command returns a list of application components and subsystems that have monitoring enabled, for example:
server.resources server.connector-service server.orb server.jms-service server.jvm server.applications server.http-service server.thread-pools |
To display monitoring statistics for an application component or subsystem for which monitoring has been enabled, use the asadmin get command.
To get the statistics, type the asadmin get command in a terminal window, specifying a name displayed by the list command in the preceding step. The following example attempts to get all attributes from a subsystem for a specific object:
asadmin> get --user adminuser --monitor server.jvm.* |
The command returns the following attributes and data:
server.jvm.dotted-name = server.jvm server.jvm.heapsize-current = 21241856 server.jvm.heapsize-description = Provides statistical information about the JVM's memory heap size. server.jvm.heapsize-highwatermark = 21241856 server.jvm.heapsize-lastsampletime = 1080232913938 server.jvm.heapsize-lowerbound = 0 server.jvm.heapsize-lowwatermark = 0 server.jvm.heapsize-name = JvmHeapSize server.jvm.heapsize-starttime = 1080234457308 server.jvm.heapsize-unit = bytes server.jvm.heapsize-upperbound = 518979584 server.jvm.uptime-count = 1080234457308 server.jvm.uptime-description = Provides the amount of time the JVM has been running. server.jvm.uptime-lastsampletime = 1080234457308 server.jvm.uptime-name = JvmUpTime server.jvm.uptime-starttime = 1080232913928 server.jvm.uptime-unit = milliseconds |
In the asadmin list and get commands, specify the dotted name of monitorable objects. All child objects are addressed using the dot (.) character as separator, thus these are referred to as dotted names. If a child node is of singleton type, then only the monitoring object type is needed to address the object, otherwise a name of the form type.name is needed to address the object.
For example, http-service is one of the valid monitorable object types and is a singleton. To address a singleton child node representing the http-service of instance server, the dotted name is:
server.http-service
Another example, application, is a valid monitorable object type and is not a singleton. To address a non-singleton child node representing, for example, the application PetStore, the dotted name is:
server.applications.petstore
The dotted names can also address specific attributes in monitorable objects. For example, http-service has a monitorable attribute called bytesreceived-lastsampletime. The following name addresses the bytesreceived attribute:
server.http-service.server.http-listener-1. bytesreceived-lastsampletime
The administrator is not expected to know the valid dotted names for asadmin list and get commands. The list command displays available monitorable objects, while the get command used with a wildcard parameter allows the inspection of all available attributes on any monitorable object.
The underlying assumptions for using the list and get commands with dotted names are:
Any list command that has a dotted name that is not followed by a wildcard (*) gets as its result the current node’s immediate children. For example, list --user adminuser --monitor server lists all immediate children belonging to the server node.
Any list command that has a dotted name followed by a wildcard of the form .* gets as its result a hierarchical tree of children nodes from the current node. For example, list --user adminuser --monitor server.applications.* lists all children of applications and their subsequent child nodes and so on.
Any list command that has a dotted name preceded or followed by a wildcard of the form *dottedname or dotted * name or dotted name * gets as its result all nodes and their children matching the regular expression created by the provided matching pattern.
A get command followed by a .* or a * gets as its result the set of attributes and their values belonging to the current node to be matched.
For more information, see Expected Output for list and get Commands at All Levels.
The list command provides information about the application components and subsystems currently being monitored for the specified server instance name. Using this command, you can see the monitorable components and subcomponents for a server instance. For a more complete listing of list examples, see Expected Output for list and get Commands at All Levels.
asadmin> list --user admin-user --monitor server |
The preceding command returns a list of application components and subsystems that have monitoring enabled, for example:
server.resources server.orb server.jvm server.jms-service server.connector-service server.applications server.http-service server.thread-pools |
It is also possible to list applications that are currently monitored in the specified server instance. This is useful when particular monitoring statistics are sought from an application using the get command.
asadmin> list --user admin-user --monitor server.applications
Returns:
server.applications.adminapp server.applications.admingui server.applications.myApp
The get command retrieves the following monitored information:
All attribute(s) monitored within a component or subsystem
Specific attribute monitored within a component or subsystem
When an attribute is requested that does not exist for a particular component or subsystem, an error is returned. Similarly, when a specific attribute is requested that is not active for a component or subsystem, an error is returned.
Refer to Expected Output for list and get Commands at All Levels for more information on the use of the get command.
Attempt to get all attributes from a subsystem for a specific object:
asadmin> get --user admin-user --monitor server.jvm.* |
Returns:
server.jvm.dotted-name= server.jvm server.jvm.heapsize-current = 21241856 server.jvm.heapsize-description = Provides statistical information about the JVM's memory heap size. server.jvm.heapsize-highwatermark = 21241856 server.jvm.heapsize-lastsampletime = 1080232913938 server.jvm.heapsize-lowerbound = 0 server.jvm.heapsize-lowwatermark = 0 server.jvm.heapsize-name = JvmHeapSize server.jvm.heapsize-starttime = 1080234457308 server.jvm.heapsize-unit = bytes server.jvm.heapsize-upperbound = 518979584 server.jvm.uptime-count = 1080234457308 server.jvm.uptime-description = Provides the amount of time the JVM has been running. server.jvm.uptime-lastsampletime = 1080234457308 server.jvm.uptime-name = JvmUpTime server.jvm.uptime-starttime = 1080232913928 server.jvm.uptime-unit = milliseconds |
Attempt to get all attributes from a J2EE application:
asadmin> get --user admin-user --monitor server.applications.myJ2eeApp.* |
Returns:
No matches resulted from the wildcard expression. CLI137 Command get failed. |
There are no monitorable attributes exposed at the J2EE-application level, therefore this reply displays.
Attempt to get a specific attribute from a subsystem:
asadmin> get --user admin-user --monitor server.jvm.uptime-lastsampletime |
Returns:
server.jvm.uptime-lastsampletime = 1093215374813
Attempt to get an unknown attribute from within a subsystem attribute:
asadmin> get --user admin-user --monitor server.jvm.badname |
Returns:
No such attribute found from reflecting the corresponding Stats interface: [badname] CLI137 Command get failed. |
The following example illustrates how the asadmin tool might be used for monitoring purposes.
A user wants to inspect the number of calls made to a method in the sample PetStore application after it has been deployed onto the Application Server. The instance onto which it has been deployed is named server. A combination of the list and get commands are used to access desired statistics on a method.
Start the Application Server and the asadmin tool.
Set some useful environment variables to avoid entering them for every command:
asadmin> export AS_ADMIN_USER=admin AS_ADMIN_PASSWORD=admin123 asadmin>export AS_ADMIN_HOST=localhost AS_ADMIN_PORT=4849 |
List monitorable components for instance server:
asadmin> list --user adminuser --monitor server* |
Returns (output will be similar to):
server server.applications server.applications.CometEJB server.applications.ConverterApp server.applications.petstore server.http-service server.resources server.thread-pools |
The list of monitorable components includes thread-pools, http-service, resources, and all deployed (and enabled) applications.
List the monitorable subcomponents in the PetStore application (-m can be used instead of --monitor):
asadmin> list -m server.applications.petstore
Returns:
server.applications.petstore.signon-ejb_jar server.applications.petstore.catalog-ejb_jar server.applications.petstore.uidgen-ejb_jar server.applications.petstore.customer-ejb_jar server.applications.petstore.petstore-ejb_jar server.applications.petstore.petstore\.war server.applications.petstore.AsyncSenderJAR_jar server.applications.petstore.cart-ejb_jar |
List the monitorable subcomponents in the EJB module signon-ejb_jar of the PetStore application:
asadmin> list -m server.applications.petstore.signon-ejb_jar |
Returns:
server.applications.petstore.signon-ejb_jar.SignOnEJB server.applications.petstore.signon-ejb_jar.UserEJB |
List the monitorable subcomponents in the entity bean UserEJB for the EJB module signon-ejb_jar of the PetStore application:
asadmin> list -m server.applications.petstore.signon-ejb_jar.UserEJB |
Returns (with dotted name removed for space considerations):
server.applications.petstore.signon-ejb_jar.UserEJB.bean-cache server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods server.applications.petstore.signon-ejb_jar.UserEJB.bean-pool |
List the monitorable subcomponents in the method getUserName for the entity bean UserEJB in the EJB module signon-ejb_jar of the PetStore application:
asadmin> list -m server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods.getUserName |
Returns:
Nothing to list at server.applications.petstore.signon-ejb_jar. UserEJB.bean-methods.getUserName. To get the valid names beginning with a string, use the wildcard "*" character. For example, to list all names that begin with "server", use "list server*". |
There are no monitorable subcomponents for methods. Get all monitorable statistics for the method getUserName.
asadmin> get -m server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods.getUserName.* |
Returns:
server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.executiontime-count = 0 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.executiontime-description = Provides the time in milliseconds spent during the last successful/unsuccessful attempt to execute the operation. server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.executiontime-lastsampletime = 1079981809259 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.executiontime-name = ExecutionTime server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.executiontime-starttime = 1079980593137 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.executiontime-unit = count server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.methodstatistic-count = 0 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.methodstatistic-description = Provides the number of times an operation was called, the total time that was spent during the invocation and so on. server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.methodstatistic-lastsampletime = 1079980593137 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.methodstatistic-maxtime = 0 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.methodstatistic-mintime = 0 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.methodstatistic-name = ExecutionTime server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.methodstatistic-starttime = 1079980593137 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.methodstatistic-totaltime = 0 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.methodstatistic-unit = server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumerrors-count = 0 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumerrors-description = Provides the total number of errors that occured during invocation or execution of an operation. server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumerrors-lastsampletime = 1079981809273 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumerrors-name = TotalNumErrors server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumerrors-starttime = 1079980593137 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumerrors-unit = count server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumsuccess-count = 0 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumsuccess-description = Provides the total number of successful invocations of the method. server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumsuccess-lastsampletime = 1079981809255 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumsuccess-name = TotalNumSuccess server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumsuccess-starttime = 1079980593137 server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.totalnumsuccess-unit = count |
To also get a specific statistic, such as execution time, use a command such as the following:
asadmin> get -m server.applications.petstore.signon-ejb_jar. UserEJB.bean-methods.getUserName.executiontime-count |
Returns:
server.applications.petstore.signon-ejb_jar.UserEJB.bean-methods. getUserName.executiontime-count = 1 |
The following tables show the command, dotted name, and corresponding output at each level of the tree.
Table 16–33 Top Level
Command |
Dotted Name |
Output |
|
---|---|---|---|
list -m |
server |
|
|
list -m |
server.* |
Hierarchy of child nodes below this node. |
|
get -m |
server.* |
No output except a message saying there are no attributes at this node. |
The following table shows the command, dotted name, and corresponding output for the applications level.
Table 16–34 Applications Level
Command |
Dotted Name |
Output |
|
---|---|---|---|
list -m |
server.applications or *applications |
|
|
list -m |
server.applications.* or *applications.* |
Hierarchy of child nodes below this node. |
|
get -m |
server.applications.* or *applications.* |
No output except message saying there are no attributes at this node. |
The following table shows the command, dotted name, and corresponding output for stand-alone modules and enterprise applications at the applications level.
Table 16–35 Applications - Enterprise Applications and Standalone Modules
Command |
Dotted Name |
Output |
|
---|---|---|---|
list -m |
server.applications.app1 or *app1 Note: this level is only applicable if an enterprise application has been deployed. It is not applicable if a standalone module is deployed. |
ejb-module1_jarweb-module2_warejb-module3_jarweb-module3_war... |
|
list -m |
server.applications.app1.* or *app1.* |
Hierarchy of child nodes below this node. |
|
get -m |
server.applications.app1.* or *app1.* |
No output except message saying there are no attributes at this node. |
|
list -m |
server.applications.app1.ejb-module1_jar or *ejb-module1_jar or server.applications.ejb-module1_jar |
bean1bean2bean3... |
|
list -m |
server.applications.app1.ejb-module1_jar or *ejb-module1_jar or server.applications.ejb-module1_jar |
Hierarchy of child nodes below this node. |
|
get -m |
server.applications.app1.ejb-module1_jar.* or *ejb-module1_jar.* or server.applications.ejb-module1_jar.* |
No output except message saying there are no attributes at this node. |
|
list -m |
server.applications.app1.ejb-module1_jar.bean1 Note: In standalone modules, the node containing the application name (app1 in this example) will not appear. |
List of child nodes: bean-poolbean-cachebean-method |
|
list -m |
server.applications.app1.ejb-module1_jar.bean1 Note: In standalone modules, the node containing the application name (app1 in this example) will not appear. |
Hierarchy of child nodes and a list of all attributes for this node and for any subsequent child nodes. |
|
get -m |
server.applications.app1.ejb-module1_jar.bean1.* Note: In standalone modules, the node containing the application name (app1 in this example) does not appear. |
The following attributes and their associated values:
|
|
list -m |
server.applications.app1.ejb-module1_jar.bean1.bean-pool Note: In standalone modules, the node containing the application name (app1 in this example) will not appear. |
No attributes, but a message saying: Nothing to list at server.applications.appl.ejb-module1_jar.bean1-cache. To get the valid names beginning with a string, use the wildcard (*) character. For example, to list all names that begin with server, use list server*. |
|
get -m |
server.applications.app1.ejb-module1_jar.bean1.bean-pool.* Note: In standalone modules, the node containing the application name (app1 in this example) will not appear. |
List of attributes and values corresponding to EJB Pool attributes as described in Table 1-4. |
|
list -m |
server.applications.app1.ejb-module1_jar.bean1.bean-cache Note: In standalone modules, the node containing the application name (app1 in this example) will not appear. |
No attributes, but a message saying “Use get command with the --monitor option to view this node’s attributes and values.” |
|
get -m |
server.applications.app1.ejb-module1_jar.bean1.bean-cache.* Note: In standalone modules, the node containing the application name (app1 in this example) does not appear. |
List of attributes and values corresponding to EJB Cache attributes as described in Table 1-5. |
|
list -m |
server.applications.app1.ejb-module1_jar.bean1.bean-method.method1 Note: In standalone modules, the node containing the application name (app1 in this example) will not appear. |
No attributes, but a message saying “Use get command with the --monitor option to view this node’s attributes and values.” |
|
get -m |
server.applications.app1.ejb-module1_jar.bean1.bean-method.method1.* Note: In standalone modules, the node containing the application name (app1 in this example) will not appear. |
List of attributes and values corresponding to EJB Methods attributes as described in Table 1-2. |
|
list -m |
server.applications.app1.web-module1_war |
Displays the virtual server(s) assigned to the module. |
|
get -m |
server.applications.app1.web-module1_war.* |
No output except a message saying there are no attributes at this node. |
|
list -m |
server.applications.app1.web-module1_war.virtual_server |
Displays list of servlets registered. |
|
get -m |
server.applications.app1.web-module1_war.virtual_server.* |
No output except a message saying there are no attributes at this node. |
|
list -m |
server.applications.app1.web-module1_war.virtual_server.servlet1 |
No attributes, but a message saying “Use get command with the --monitor option to view this node’s attributes and values.” |
|
get -m |
server.applications.app1.web-module1_war.virtual_server.servlet1.* |
List of attributes and values corresponding to web container (Servlet) attributes as described in Table 1-7. |
The following table shows the command, dotted name, and corresponding output for the HTTP Service level.
Table 16–36 HTTP-Service Level
Command |
Dotted Name |
Output |
---|---|---|
list -m |
server.http-service |
List of virtual servers. |
get -m |
server.http-service.* |
No output except message saying there are no attributes at this node. |
list -m |
server.http-service.server |
List of HTTP Listeners. |
get -m |
server.http-service.server.* |
No output except message saying there are no attributes at this node. |
list -m |
server.http-service.server.http-listener1 |
No attributes, but a message saying “Use get command with the --monitor option to view this node’s attributes and values.” |
get -m |
server.http-service.server.* |
List of attributes and values corresponding to HTTP Service attributes. |
The following table shows the command, dotted name, and corresponding output for the thread pools level.
Table 16–37 Thread-Pools Level
Command |
Dotted Name |
Output |
---|---|---|
list -m |
server.thread-pools |
List of thread-pool names. |
get -m |
server.thread-pools.* |
No output except message saying there are no attributes at this node. |
list -m |
server.thread-pools.orb\.threadpool\.thread-pool-1 |
No attributes, but a message saying “Use get command with the --monitor option to view this node’s attributes and values.” |
get -m |
server.thread-pools..orb\.threadpool\.thread-pool-1.* |
List of attributes and values corresponding to Thread Pool attributes. |
The following table shows the command, dotted name, and corresponding output for the resources level.
Table 16–38 Resources Level
Command |
Dotted Name |
Output |
---|---|---|
list -m |
server.resources |
List of pool names. |
get -m |
server.resources.* |
No output except message saying there are no attributes at this node. |
list -m |
server.resources.jdbc-connection-pool-pool.connection-pool1 |
No attributes, but a message saying “Use get command with the --monitor option to view this node’s attributes and values.” |
get -m |
server.resources.jdbc-connection-pool-pool.connection-pool1.* |
List of attributes and values corresponding to Connection Pool attributes. |
The following table shows the command, dotted name, and corresponding output for the transaction service level.
Table 16–39 Transaction-Service Level
Command |
Dotted Name |
Output |
---|---|---|
list -m |
server.transaction-service |
No attributes, but a message saying “Use get command with the --monitor option to view this node’s attributes and values.” |
get -m |
server.transaction-service.* |
List of attributes and values corresponding to Transaction Service attributes. |
The following table shows the command, dotted name, and corresponding output for the ORB level.
Table 16–40 ORB Level
Command |
Dotted Name |
Output |
---|---|---|
list -m |
server.orb |
server-orb.connection-managers |
get -m |
server.orb.* |
No output except message saying there are no attributes at this node. |
list -m |
server.orb.connection-managers |
Name(s) of ORB connection managers. |
get -m |
server.orb.connection-managers.* |
No output except message saying there are no attributes at this node. |
list -m |
server.orb.connection-managers.orb\.Connections\.Inbound\.AcceptedConnections |
No attributes, but a message saying “Use get command with the --monitor option to view this node’s attributes and values.” |
get -m |
server.orb.connection-managers.orb\.Connections\.Inbound\.AcceptedConnections.* |
List of attributes and values corresponding to ORB Connection Manager attributes. |
The following table shows the command, dotted name, and corresponding output for the JVM level.
Table 16–41 JVM Level
Command |
Dotted Name |
Output |
---|---|---|
list -m |
server.jvm |
No attributes, but a message similar to the following displays: Use get command with the --monitor option to view this node’s attributes and values. |
get -m |
server.jvm.* |
List of attributes and values corresponding to JVM attributes. |
This section contains the following topics:
Administration (management and monitoring) of the Application Server is based on JMX. This means that the managed components are represented as MBeans. With Java 2 Standard Edition (J2SE) 5.0, you can monitor the JVM and view the JVM MBeans to understand what is going on there. To expose this instrumentation, Application Server provides a configuration of Standard JMX Connector Server called System JMX Connector Server. When the Application Server starts up, an instance of this JMX Connector Server starts up, exposing the instrumentation to trusted clients.
The Java Monitoring and Management Console (JConsole) is a popular JMX Connector that can manage a JMX backend. JConsole (http://java.sun.com/j2se/1.5.0/docs/tooldocs/share/jconsole.html) is available as part of the standard JDK distribution beginning with J2SE 5.0. For more information on JConsole, see http://java.sun.com/developer/technicalArticles/J2SE/jconsole.html
When you configure JConsole with Application Server, the Application Server becomes the JMX Connector's server-end and JConsole becomes the JMX Connector's preferred client-end.
There are subtle differences in how to connect to Application Server, or any JMX Connector Server end based on the transport layer security of the connection. If the server end is secure (guarantees transport layer security), there is a little more configuration to be performed on the client end.
By default, Platform Edition of Application Server has System JMX Connector Server end as insecure.
By default, Enterprise Edition of Application Server has System JMX Connector Server end as secure.
The protocol used for communication is RMI/JRMP. If security is enabled for the JMX Connector, the protocol used is RMI/JRMP over SSL.
RMI over SSL does not provide additional checks to ensure that the client is talking to the intended server. Thus, there is always a possibility, while using JConsole, that you are sending the user name and password to a malicious host. It is completely up to the administrator to make sure that security is not compromised.
When you install a Platform Edition domain on a machine such as appserver.sun.com, you will see the following in the DAS's (Domain Administration Server, the admin server or simply the domain) domain.xml:
<!- – The JSR 160 "system-jmx-connector" – –><jmx-connector accept-all="false" address="0.0.0.0" auth-realm-name="admin-realm" enabled="true" name="system" port="8686" protocol="rmi_jrmp" security-enabled="false"/><!- – The JSR 160 "system-jmx-connector" – –>
The security-enabled flag for the JMX Connector is false. If you are running the Enterprise Edition, or if you have turned on security for the JMX Connector in the Platform Edition, this flag is set to true.
<!- – The JSR 160 "system-jmx-connector" – –><jmx-connector accept-all="false" address="0.0.0.0" auth-realm-name="admin-realm" enabled="true" name="system" port="8686" protocol="rmi_jrmp" security-enabled="true"/>...</jmx-connector><!- – The JSR 160 "system-jmx-connector" – –>
The JConsole setup has two parts: a server end and a client end. The Application Server domain is installed on a machine called appserver.sun.com, which is a powerful Solaris server. This is the server end.
The client end also has an installation of Application Server. Let us assume that the client end is a Windows machine with Java SE 5.0 and Application Server installed.
The Application Server installation is needed on the client end only when your Application Server domain has security enabled on the remote machine (the default for Enterprise Edition). If you just want to administer an Application Server Platform Edition domain on the Solaris machine above, you do not need the Application Server installation on this client machine.
If the server and client ends are on the same machine, you can use localhost to specify the host name.
This section describes connecting JConsole to Application Server without security enabled on the JMX Connector. By default, security is not enabled on Application Server Platform Edition.
Start the domain on appserver.sun.com.
Start JConsole by running JDK_HOME/bin/jconsole
In the Connect to Agent tab of JConsole, enter user name, password, host name and port (8686, by default).
The user name refers to the admin user name and password refers to the admin password of the domain.
Click Connect.
In the JConsole window you will see all your MBeans, VM information etc., in various tabs.
This section describes how to connect JConsole to Application Server with security enabled on the JMX Connector. By default, security is enabled on Application Server Enterprise Edition. Use this procedure if you have security enabled on the Platform Edition's JMX Connector.
Install Application Server on the client machine (where JConsole is installed).
The only reason you need this is to let JConsole know where the server certificate of the Domain Administration Server that you trust is located. To obtain that certificate, invoke at least one remote asadmin command and to do that, you need the local installation of Application Server.
Start the Application Server Enterprise Edition on appserver.sun.com.
Since this is an Enterprise Edition domain, the system JMX Connector server is secure.
From the local Application Server installation, run install-dir/bin/asadmin list --user admin --secure=true --host appserver.sun.com --port 4849 (where 4849 is the server's admin port).
Though asadmin list command is chosen for this example, you can run any remote asadmin command. You will now be prompted to accept the certificate sent by the DAS of appserver.sun.com.
Press y to accept the certificate sent by the Domain Administration Server on appserver.sun.com.
The server's certificate is stored in a file called .asadmintruststore in your home directory on the client machine.
This step is not required if your server machine and client machine is the same. That is, if you are running JConsole also on appserver.sun.com.
Let JConsole know the DAS's trust store location by using the following JConsole command:
JDK-dir/bin/jconsole.exe -J-Djavax.net.ssl.trustStore="C:/Documents and Settings/user/.asadmintruststore"
This certificate is now automatically trusted by JConsole.
Start JConsole by running JDK_HOME/bin/jconsole
In the Connect to Agent tab of JConsole, enter user name, password, host name and port (8686, by default).
The user name refers to the admin user name and password refers to the admin password of the domain.
Click Connect.
In the JConsole window you will see all your MBeans, VM information etc., in various tabs.