This utility provides statistics acquired from different system counters. Here is a current list of available counter objects:
Each entry represents a counter object and supplies a variety of useful counts for this object. In this section we will only be discussing the alarm, diskusage, serverresponse, popstat, imapstat, and httpstat counter objects. For details on counterutil command usage, refer to counterutil in Sun Java System Messaging Server 6.3 Administration Reference.
counterutil has a variety of flags. A command format for this utility may be as follows:
counterutil -o CounterObject -i 5 -n 10
where,
-o CounterObject represents the counter object alarm, diskusage, serverresponse, popstat, imapstat, and httpstat.
-i 5 specifies a 5 second interval.
-n 10 represents the number of iterations (default: infinity).
An example of counterutil usage is as follows:
# counterutil -o imapstat -i 5 -n 10 Monitor counteroobject (imapstat) registry /gotmail/iplanet/server5/msg-gotmail/counter/counter opened counterobject imapstat opened count = 1 at 972082466 rh = 0xc0990 oh = 0xc0968 global.currentStartTime [4 bytes]: 17/Oct/2000:12:44:23 -0700 global.lastConnectionTime [4 bytes]: 20/Oct/2000:15:53:37 -0700 global.maxConnections [4 bytes]: 69 global.numConnections [4 bytes]: 12480 global.numCurrentConnections [4 bytes]: 48 global.numFailedConnections [4 bytes]: 0 global.numFailedLogins [4 bytes]: 15 global.numGoodLogins [4 bytes]: 10446 ... |
These alarm statistics refer to the alarms sent by stored.The alarm counter provides the following statistics:
Table 27–1 counterutil alarm Statistics
Suffix |
Description |
---|---|
alarm.countoverthreshold |
Number of times crossing threshold. |
alarm.countwarningsent |
Number of warnings sent. |
alarm.current |
Current monitored valued. |
alarm.high |
Highest ever recorded value. |
alarm.low |
Lowest ever recorded value. |
alarm.timelastset |
The last time current value was set. |
alarm.timelastwarning |
The last time warning was sent. |
alarm.timereset |
The last time reset was performed. |
alarm.timestatechanged |
The last time alarm state changed. |
alarm.warningstate |
Warning state (yes(1) or no(0)). |
To get information on the number of current IMAP, POP, and HTTP connections, number of failed logins, total connections from the start time, and so forth, you can use the command counterutil -o CounterObject -i 5 -n 10.where CounterObject represents the counter object popstat, imapstat, or httpstat. The meaning of the imapstat suffixes is shown in Table 27–2. The popstat and httpstat objects provide the same information in the same format and structure.
Table 27–2 counterutil imapstat Statistics
Suffix |
Description |
---|---|
currentStartTime |
Start time of the current IMAP server process. |
lastConnectionTime |
The last time a new client was accepted. |
maxConnections |
Maximum number of concurrent connections handled by IMAP server. |
numConnections |
Total number of connections served by the current IMAP server. |
numCurrentConnections |
Current number of active connections. |
numFailedConnections |
Number of failed connections served by the current IMAP server. |
numFailedLogins |
Number of failed logins served by the current IMAP server. |
numGoodLogins |
Number of successful logins served by the current IMAP server. |
The command: counterutil -o diskusage generates following information:
Table 27–3 counterutil diskstat Statistics
Suffix |
Description |
---|---|
diskusage.availSpace |
Total space available in the disk partition. |
diskusage.lastStatTime |
The last time statistic was taken. |
diskusage.mailPartitionPath |
Mail partition path. |
diskusage.percentAvail |
Disk partition space available percentage. |
diskusage.totalSpace |
Total space in the disk partition. |
The command: counterutil -o serverresponse generates following information. This information is useful for checking if the servers are running, and how quickly they’re responding.
Table 27–4 counterutil serverresponse Statistics
Suffix |
Description |
---|---|
http.laststattime |
Last time http server response was checked. |
http.responsetime |
Response time for the http. |
imap.laststattime |
Last time imap server response was checked. |
imap.responsetime |
Response time for the imap. |
pop.laststattime |
Last time pop server response was checked. |
pop.responsetime |
Response time for the pop. |