Name | Synopsis | Description | Options | Operands | Examples | Exit Status | See Also
monitor [--terse={true|false}][ --echo={true|false} ] [ --interactive={true|false} ] [ --host host] [--port port] [--secure| -s ] [ --user admin_user] [--passwordfile filename] [--help] --type monitor_type [--filename file_name] [--interval interval] [--filter filter_name] instance_name
This command prints out commonly-monitored attributes of Enterprise Server components, and has options for filtering out statistics 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.
To monitor information for a given attribute, the attribute's monitoring level must be set to HIGH or LOW. Set the monitoring level through the Admin Console, or use the set command.
Indicates that any output data must be very concise, typically avoiding human-friendly sentences and favoring well-formatted data for consumption by a script. Default is false.
Setting to true will echo the command line statement on the standard output. Default is false.
If set to true (default), only the required password options are prompted.
The machine name where the domain administration server is running. The default value is localhost.
The HTTP/S port for administration. This is the port to which you should point your browser in order to manage the domain. For example, http://localhost:4848.
The default port number is 4848.
If set to true, uses SSL/TLS to communicate with the domain administration server.
The authorized domain administration server administrative username.
If you have authenticated to a domain using the asadmin login command, then you need not specify the --user option on subsequent operations to this particular domain.
The --passwordfile option specifies the name, including the full path, of a file containing the password entries in a specific format. The entry for the password must have the AS_ADMIN_ prefix followed by the password name in uppercase letters.
For example, to specify the domain administration server password, use an entry with the following format: AS_ADMIN_PASSWORD=password, where password is the actual administrator password. Other passwords that can be specified include AS_ADMIN_MAPPEDPASSWORD, AS_ADMIN_USERPASSWORD, and AS_ADMIN_ALIASPASSWORD.
All remote commands must specify the admin password to authenticate to the domain administration server, either through --passwordfile or asadmin login, or interactively on the command prompt. The asadmin login command can be used only to specify the admin password. For other passwords, that must be specified for remote commands, use the --passwordfile or enter them at the command prompt.
If you have authenticated to a domain using the asadmin login command, then you need not specify the admin password through the --passwordfile option on subsequent operations to this particular domain. However, this is applicable only to AS_ADMIN_PASSWORD option. You will still need to provide the other passwords, for example, AS_ADMIN_USERPASSWORD, as and when required by individual commands, such as update-file-user.
For security reasons, passwords specified as an environment variable will not be read by asadmin.
The default value for AS_ADMIN_MASTERPASSWORD is changeit.
Displays the help text for the command.
The type of statistics to monitor. Valid values are:
connection
connectionqueue
connectorpool
endpoint
entitybean
filecache
httplistener
httpservice
jdbcpool
jvm
keepalive
messagedriven
servlet
statefulsession
statelesssession
threadpool
webmodule
Saves output to a file in CSV format.
The interval in seconds before capturing monitoring attributes. If the interval must be greater than 0. The monitoring attributes are displayed on stdout until you type ctrl-c or q. The default value is 30.
If there is more than one monitorable element in the given type, use this option to filter the results to get the information you want.
For the following examples, enable monitoring for the type before running the commands. For example:
asadmin set server.monitoring-service.module-monitoring-levels.jvm=LOW |
asadmin> monitor --type jvm --user admin --passwordfile password.txt server JVM Monitoring UpTime(ms) HeapSize(bytes) current min max low high count 327142979 0 531628032 0 45940736 45940736 |
The following example shows a type for which there are multiple monitoring options when the filter option is not used:
asadmin> monitor --type httplistener --user admin --passwordfile password.txt server |
There are more than one monitoring elements. Please consider using the filter option. The following are available elements to monitor: http-listener-1 http-listener-2 CLI137 Command monitor failed. |
Using the filter option:
asadmin> monitor --type httplistener --filter http-listener-1 --user admin --passwordfile password.txt 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 3 |
Enter h to see the legend for the table headings:
****************************************************************************************** * 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 * ****************************************************************************************** |
Name | Synopsis | Description | Options | Operands | Examples | Exit Status | See Also