monitor — report current status of Kernun proxies
monitor [-g [-f]] [-d ] [dir-o ] [file-w ] [sec-r ] [sec-c ] [cols-t
[n-T ]] [col-s ] [col-R ] [typeapplication...]
Utility monitor provides a user interface
to the Kernun application runtime monitoring facility.
It reads the monitoring communication files
created by running applications, processes the data, and generates reports.
A report can be generated once or periodically, see option
-r.
The format of the report is either plain text or an HTML document.
The report can be sorted by various criteria and contains
information about all active proxy sessions or other entities,
or only about a subset of them.
It is possible to select applications by name (argument
proxy-d).
Another alternative is to show only top values,
for example, only the 10 sessions with the largest amount of data
downloaded from a server.
HTML output is intended for remote access to data monitoring. Remote
access requires an HTTP server (secure and properly configured) on the
firewall. If the server does not support CGI scripts or the security
policy forbids them, monitor may be started as a daemon with
-h, -r and other arguments that choose
a fixed format of displayed information. The monitor then periodically
generates a report as a static HTML page. If the monitor is used as a CGI
script, it is possible to augment the report (-f) with
a form that allows setting some report parameters.
Option -r in
both versions of HTML output instructs the user's browser to periodically
refresh the page.
-c colsSelects the displayed colums, cols is a comma-separated list of column types (see below).
-d dirSpecifies a directory containing monitoring communication files. If not set, the current working directory is used by default.
-fAdds a form for selecting some parameters to HTML output, processes input from the form.
Textual output is generated if neither -g
nor -f is used.
-gGenerates HTML output.
-o fileStores the output to a file instead of sending it to the standard output.
-r secRefreshes the report with given period (in
seconds). HTML output will contain a Refresh header in order to
automatically reload the page in a browser. If started as a CGI
script, monitor always exits after the first report is generated,
regardless of -r.
-R typePrint data from records of given type (see below).
-s colThe column type used for sorting the output. If
not set, sin is used.
-t nShows only top n entries with
the highest values (or the oldest time).
-T colThe column type used for
-t. If not set, sin is used.
Only times, byte counts, and speeds may be used
here.
-w secSets timeout (in seconds) for waiting for monitor-dump. When reading a communication file, monitor-dump must sometimes wait until the proxy finishes modification of the file. This options prevents indefinitely long waiting in the case of a synchronization error.
application...Reports active data of these applications only. If no application is specified, all applications are reported.
The column set depends on particular record type.
SESSION record typeThis type is a default type and is used by proxies and the atrmon application.
nameProxy name, the name of
section
in the configuration *-proxy
progProxy type, the name of the proxy executable
pidPID of the process handling the session
startSession start time (hour:min:sec), prefixed with date if not today
timeCurrent session duration time (hour:min:sec)
cipClient numeric IP address and port
cnameClient name and port; IP to name resolution is done by proxy
sipServer numeric IP address and port
snameServer name and port; IP to name resolution is done by proxy
coutBytes received from the client
soutBytes sent to the server
sinBytes received from the server
cinBytes sent to the client
intMeasurement interval (in seconds) for communication speed evaluation
cosCurrent speed of data receiving from the client (bytes per second)
sosCurrent speed of data sending to the server (bytes per second)
sisCurrent speed of data receiving from the server (bytes per second)
cisCurrent speed of data sending to the client (bytes per second)
truncFlags indicating truncation of additional
variable-length data (user,
auser and file)
userUser name as authenticated by the proxy (not the user on the final server)
auserAProxy user name authenticated by http-proxy(8)
fileName of the file that is being currently downloaded/uploaded by ftp-proxy(8) or the current request URI in http-proxy(8)
allAll columns
defA default set of columns:
name,time,cname,sname,sout,sin,sos,sis
HOSTMON record typeThis type is used by host monitoring applications like atrmon and pikemon.
nameApplication name
entityEntity for which the monitoring is relevant,
i.e. a VIRTUAL-CLUSTER name
for pikemon
and a REQUEST-ACL.ADDRESS
for atrmon
groupThe name of a group with ping target hosts
target_ipParticular target host to ping
err_totTotal number of unsuccessful ping attempts
sent_totTotal number of ping sent
rtt_totAn average RTT of total responses received
age1Age of the last ping response
rtt1Round trip time of the last ping
periodLength of the last monitored period
errpNumber of unsuccessful ping attempts during the last period
sentpNumber of ping sent during the last period
rttpAn average RTT of responses received during the last period
PIKEMON record typeThis type is used by cluster monitoring application pikemon.
nameApplication name
vcnameThe VIRTUAL-CLUSTER name
host_prioThis host priority
(Primary vs. Secondary)
host_stateThis host state
(Master vs. Backup)
host_readyThis host health status
(Up vs. Down)
sensorsNumber of live sensors (ping groups and/or watched interfaces) and number of all sensors
peer_prioPeer host priority
(Primary vs. Secondary)
peer_statePeer host state
(Master vs. Backup)
peer_readyPeer host health status
(Up vs. Down)
last_helloAn age of the last HELO packet received from the peer