About Statistics

You can monitor many performance statistics through the Admin Console user interface, through the command-line interface, through the stats-xml URI, and through perfdump. For all these monitoring methods, the server uses the statistics it collects. None of these monitoring methods will work if statistics are not collected.

The statistics give you information at the configuration level, the server instance level, or the virtual server level. The statistics are broken up into functional areas.

For the configuration, statistics are available in the following areas:

• Requests

• Errors

• Response Time

For the server instance, statistics are available in the following areas:

• Requests

• Errors

• Response Time

• General

• Java Virtual Machine (JVM^TM)

• Connection Queue

• Keep Alive

• DNS

• File Cache

• Thread Pools

• Session Replication

• Session Threads, including Profiling data (available if profiling is enabled)

• Java DataBase Connectivity (JDBC^TM) (available if a JDBC resource is created and the connection pool is accessed)

For the virtual server, statistics are available in the following areas:

• General

• Response

• Web Applications

• Profiling Data (available if profiling is enabled)

• Servlet and Servlet Response Cache (available if the Servlet cache is enabled in sun.web.xml)

Some statistics default to zero if Quality of Service (QoS) is not enabled, for example, the count of open connections, the maximum open connections, the rate of bytes transmitted, and the maximum byte transmission rate.

Enabling Statistics

Statistics are activated by default on Web Server. However, if you have disabled them, you need to enable them again to monitor your server for performance. To enable statistics, use Admin Console or the wadm command-line utility (CLI).

Collecting statistics causes a slight hit to performance.

To Enable Statistics from the Admin Console

1. From the Admin Console Common Tasks page, select the configuration.

2. Click Edit Configuration.

3. Click the General tab.

4. Click the Monitoring Settings sub tab.

5. On the Monitoring Settings page, under General Settings, select the Statistics Enabled checkbox.

6. Configure the interval and profiling.

   • The Interval is the period in seconds between statistics updates. A higher setting with less frequent updates improves performance. The minimum value is .001 seconds; the default value is 5 seconds.

   • Profiling is activated by default. Deactivating it results in slightly less monitoring overhead.

7. Restart the server.

To Enable Statistics from the CLI

1. Enter the following CLI command to enable statistics collection:

   ./wadm set-stats-prop --user=admin_user –password-file=password-file --config=myconfig enabled=true

   To disable statistics, set enabled to false.

2. To set the interval and enable profiling, use the set-stats-prop interval and profiling properties. For more information, see the help for set-stats-prop.

3. Restart the server.