Monitoring Current Activity Using the perfdump Utility

The perfdump utility is a Server Application Function (SAF) built into Sun Java System Web Server that collects various pieces of performance data from the Web Server internal statistics and displays them in ASCII text. The perfdump utility allows you to monitor a greater variety of statistics than those available through the Server Manager.

With perfdump, the statistics are unified. Rather than monitoring a single process, statistics are multiplied by the number of processes, which gives you a more accurate view of the server as a whole.

Installing the perfdump Utility

To install perfdump, make the following modifications in obj.conf

1. Add the following object to your obj.conf file after the default object:

   <Object name="perf">Service fn="service-dump"</Object>

2. Add the following to the default object:

   NameTrans fn=assign-name from="/.perf" name="perf"

   Make sure that the .perf NameTrans directive is specified before the document-root NameTrans directive in the default object.

3. If not already activated, activate stats-xml.

   For more information, see Activating Statistics

4. Restart your server software.

5. Access perfdump by entering this URL:

   http://yourhost/.perf

   You can request the perfdump statistics and specify how frequently (in seconds) the browser should automatically refresh. The following example sets the refresh to every 5 second

   http://yourhost/.perf?refresh=5

See Also

Using Statistics to Tune Your Server

Sample perfdump Output

The following is sample perfdump output:

------------------------------------------------------------
webservd pid: 2408

ConnectionQueue:
----------------------------------
Current/Peak/Limit Queue Length     0/0/4096
Total Connections Queued            0
Average Queueing Delay              0.00 milliseconds

ListenSocket ls1:
------------------------
Address                   http://0.0.0.0:8080
Acceptor Threads          1
Default Virtual Server    https-iws-files2.red.iplanet.com

KeepAliveInfo:
--------------------
KeepAliveCount        0/256
KeepAliveHits         0
KeepAliveFlushes      0
KeepAliveRefusals     0
KeepAliveTimeouts     0
KeepAliveTimeout      30 seconds

SessionCreationInfo:
------------------------
Active Sessions           1
Total Sessions Created    48/128

CacheInfo:
------------------
enabled             yes
CacheEntries        0/1024
Hit Ratio           0/0 (  0.00%)
Maximum Age         30

Native pools:
----------------------------
NativePool:
Idle/Peak/Limit               1/1/128
Work Queue Length/Peak/Limit  0/0/0

Server DNS cache disabled

Async DNS disabled

Performance Counters:
------------------------------------------------
                           Average        Total     Percent


Total number of requests:                     0
Request processing time:    0.0000       0.0000

default-bucket (Default bucket)
Number of Requests:                           0    (  0.00%)
Number of Invocations:                        0    (  0.00%)
Latency:                    0.0000       0.0000    (  0.00%)
Function Processing Time:   0.0000       0.0000    (  0.00%)
Total Response Time:        0.0000       0.0000    (  0.00%)

Sessions:
----------------------------
Process   Status    Function

2408      response  service-dump
------------------------------------------------------------