Sun GlassFish Enterprise Server 2.1 Administration Guide

ProcedureTo Use the asadmin get and list Commands to View Monitoring Data

The monitor command is useful in most situations. However, it does not offer the complete list of all monitorable objects. To view all monitorable data using the asadmin tool, use the asadmin list and asadmin get commands followed by the dotted name of a monitorable object, as follows.

  1. 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 enable 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.sip-service
    server.thread-pools

    For further examples using the list command, refer to Examples of the list and get Commands. For further information on the dotted names you can use with the list command, refer to Understanding and Specifying Dotted Names.

  2. 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

    For further examples using the get command, refer to Examples of the list and get Commands. For further information on the dotted names you can use with the get command, refer to Understanding and Specifying Dotted Names.