monitor
The script content on this page is for navigation purposes only and does not alter the content in any way.
monitor
Displays monitoring data for commonly used components and services
Synopsis
asadmin [asadmin-options] monitor [--help]
--type type
[--filename filename]
[--interval interval]
[--filter filter]
instance-nameDescription
The monitor subcommand displays statistics for commonly monitored
Eclipse GlassFish components and services. The --type option must be
used to specify the object for which statistics are to be displayed.
Data is displayed continuously in a tabular form, or the data can be
displayed at a particular time interval by using the --interval option.
Before a given component or service can be monitored, monitoring must be enabled (set to HIGH or LOW) for the component or service by using the Administration Console, the enable-monitoring subcommand, or the set subcommand.
The monitor subcommand has options for filtering the results and
capturing the output in a Comma Separated Values (CSV) file. The output
appears in a table format. To view the legend of the table header, type h.
This subcommand is supported in local mode only.
Options
- asadmin-options
-
Options for the
asadminutility. For information about these options, see theasadmin(1M) help page. --help-?-
Displays the help text for the subcommand.
--type-
The component or service to monitor. This option is required. No default value is defined.
httplistener-
For this type, the attribute
server.monitoring-service.module-monitoring-levels.http-servicemust be set to LOW or HIGH.
Displays the following statistics for the HTTP listener service:ec-
The total number errors in the processing of HTTP requests.
mt-
The longest response time (in milliseconds) for the processing of a single HTTP request.
pt-
The total amount of time (in milliseconds) that the HTTP listener service has spent in processing HTTP requests.
rc-
The total number of requests that the HTTP listener service has processed.
jvm-
For this type, the attribute
server.server-config.monitoring-service.module-monitoring-levels.jvmmust be set to LOW or HIGH.
Displays the following statistics for the Virtual Machine for the Java platform (Java Virtual Machine or JVM machine)UpTime-
The number of milliseconds that the JVM machine has been running since it was last started.
min-
The initial amount of memory (in bytes) that the JVM machine requests from the operating system for memory management during startup.
max-
The maximum amount of memory that can be used for memory management.
low-
Retained for compatibility with other releases.
high-
Retained for compatibility with other releases.
count-
The amount of memory (in bytes) that is guaranteed to be available for use by the JVM machine.
webmodule-
For this type, the attribute
server.server-config.monitoring-service.module-monitoring-levels.web-containermust be set to LOW or HIGH.
Displays the following statistics for all deployed web modules:asc-
The number of currently active sessions.
ast-
The total number of sessions that are currently active or have been active previously.
rst-
The total number of rejected sessions.
st-
The total number of sessions that have been created.
ajlc-
The number of currently active JavaServer Pages ( JSP) technology pages that are loaded.
mjlc-
The maximum number of JSP technology pages that were active at any time simultaneously.
tjlc-
Total number of JSP technology pages that have been loaded.
aslc-
The number of currently active Java servlets that are loaded.
mslc-
The maximum number of Java servlets that were active at any time simultaneously.
tslc-
The total number of Java servlets that have been loaded.
--filename-
Do not specify this option. This option is retained for compatibility with earlier releases. If you specify this option, a syntax error does not occur. Instead, the subcommand runs successfully and displays a warning message that the option is ignored.
--interval-
The interval in seconds before capturing monitoring attributes. The interval must be greater than 0. The monitoring attributes are displayed on
stdoutuntil you type Control-C orq. The default value is 30. --filter-
Do not specify this option. This option is retained for compatibility with earlier releases. If you specify this option, a syntax error does not occur. Instead, the subcommand runs successfully and displays a warning message that the option is ignored.
Operands
- instance-name
-
The server instance for which to view monitoring data. The default value is
server.
Examples
Example 1 Displaying Monitoring Statistics by Interval
This example displays monitoring data for the JVM machine every 2000 seconds.
asadmin> monitor --type=jvm --interval 2000 server
JVM Monitoring
UpTime(ms) Heap and NonHeap Memory(bytes)
current min max low high count
957843 29523968 188284928 0 0 60370944
q
Command monitor executed successfully.Example 2 Filtering the Monitoring Data
This example uses the filter option to show http-listener-1
statistics.
asadmin> monitor --type httplistener --filter http-listener-1 server
HTTP Listener Monitoring: http-listener-1
br bs c200 c2xx c302 c304 c3xx c400 c401 c403 c404 c4xx c503 c5xx coc co
ctc ctb ec moc mst mt mtm mst pt rc
0 0 0 0 0 3 3 0 0 0 0 0 0 0 0 0
2 0 0 1 20 20 2 2 6 3To see the legend for the table headings, type h.
******************************************************************************************
* br = Cumulative value of the Bytes received by each of the Request Processors *
* bs = Cumulative value of the Bytes sent by each of the Request Processors *
* c200 = Number of responses with a status code equal to 200 *
* c2xx = Number of responses with a status code in the 2xx range *
* c302 = Number of responses with a status code equal to 302 *
* c304 = Number of responses with a status code equal to 304 *
* c3xx = Number of responses with a status code in the 3xx range *
* c400 = Number of responses with a status code equal to 400 *
* c401 = Number of responses with a status code equal to 401 *
* c403 = Number of responses with a status code equal to 403 *
* c404 = Number of responses with a status code equal to 404 *
* c4xx = Number of responses with a status code equal to 4xx *
* c504 = Number of responses with a status code equal to 504 *
* c5xx = Number of responses with a status code equal to 5xx *
* coc = Number of open connections *
* co = Number of responses with a status code outside the 2xx, 3xx, 4xx, and 5xx range *
* ctc = Number of request processing threads currently in the listener thread pool *
* ctb = Number of request processing threads currently in use in the listener thread *
* pool serving requests *
* ec = Number of responses with a status code equal to 400 *
* moc = Maximum number of open connections *
* mst = Minimum number of request processing threads that will be created at listener *
* startup time and maintained as spare threads above the current thread count *
* mt = Maximum number of request processing threads that are created by the listener *
* mtm = Provides the longest response time for a request - not a cumulative value, but *
* the largest response time from among the response times *
* pt = Cumulative value of the times taken to process each request. The processing *
* time is the average of request processing times over the request count *
* rc = Cumulative number of the requests processed so far *
******************************************************************************************