Section: monshow (1)
Updated: $Date: Tue, 31 Jul 2001 15:54:49 -0400 $
Return to Main Contents
monshow - show operational status of mon server.
show the operational status of the
server. Both command-line and CGI interfaces are available.
Do not read configuration file, and show operational status of all groups
Instead of showing only failed services, show all services no matter the
- --detail group,service
Display detailed information for
This includes description, detailed output of the monitor,
dependency information, and more. When invoked via CGI,
append "detail=group,service" to get detail for a service.
- --view name
Display a pre-configured view. When invoked via CGI, supply
the arguments "view=name" in the URL, or by using this technique:
"http://monhost/monshow.cgi/name". For security reasons,
leading forward slashes and imbedded ".."s are removed from the
Authenticate client to the mon server.
Show disabled groups, services, and hosts. The default is to not show
anything which is disabled, but this may be overridden by the config file.
- --server hostname
Connect to the mon server on host
can be either the name of a host or an IP address.
If this name is not supplied by this argument, then the environment variable
is used, if it exists. Otherwise,
- --login username
When authenticating, use
- --port portnum
Connect to the server on
- --prot protocol
Sets the protocol to
The protocol must match the format "1.2.3". If unset, the default
supplied by the Mon::Client module is used. Do not use this parameter
unless you really know what you are doing.
Use the old 0.37 protocol and port number (32777).
- --rcfile file
Use configuration file
instead of ~/.monshowrc.
is invoked with the "REQUEST_METHOD" environment variable
set, then CGI invocation is assumed. In that case,
gathers variables and commands submitted via the
POST method and QUERY_STRING. Command-line options
are ignored for security reasons.
All reports which are produced via the web interface have a text mode
A view is a pre-defined configuration supplied to
Views can be used to generate different reports of the status
of certain services for different audiences. They are especially useful
if you are monitoring hundreds of things with mon, and you need to
see only a subset of the overall operational status.
For example, the web server admins can see a report which
has only the web server statuses, and the file server admins can
have their own report which shows only the servers. Users can customize
their own views by editing their own configurations.
Views are stored as files in a system-wide directory, typically
where each file specifies one view. If this path is not suitable
for any reason, it can be changed by modifying the
variable in the
from the command line, the view to display is specified by the
In the case of CGI invocation, views can be specified by
to the URL. For example, the following are equivalent:
If a view is not specified, then a default configuration will be
(command-line invocation) or
VIEW CONFIGURATION FILE
The view file contains a list of which services
to display, how to display them, and a number of other parameters.
Blank lines and lines beginning with a # (pound) are ignored.
- watch group
Include the status of all the services for "group".
- service group service
Include the status of the service specified by
configuration lines are present, then the status of all groups
and services are displayed.
- set show-disabled
This has the same effect as using
- set host hostname
Query the mon server
- set port number
The TCP port which the mon server is listening on.
- set prot protocol
Set the protocol. This probably should not be used unless
you really know what you're doing.
- set full
Show everything disabled, all failures, all successes, and all
- set bg color
Background color for the CGI report. The value of this
parameter should resemble "d5d5d5" (without the quotes).
- set bg-ok color
Background color for services which are in an "ok" state.
- set bg-fail color
Background color for services which are failing.
- set bg-untested color
Background color for services which have yet to be tested.
- set refresh seconds
For CGI output, set the frequency that the report reloads.
The default is to not reload.
- summary-len len
For CGI output, set the maximum length of the summary output
to display. Summary text which exceeds
will be truncated and replaced with ellipses.
- link group service URL
For the CGI report, make a link to
at the bottom of the detail report for
for more information.
- link-text group service
Insert all HTML up until a line beginning with "END"
after the link specified
- set html-header
Lines after this statement, continuing up until a line beginning
with the word "END" will be displayed after the "</head>" tag
in the CGI output. Use this to display custom headers, including
images and other fancy things.
The hostname of the server which runs the
Report bugs to the email address below.
Jim Trocki <email@example.com>
- CGI INVOCATION
- VIEW CONFIGURATION FILE
- ENVIRONMENT VARIABLES
- SEE ALSO
This document was created by
using the manual pages.
Time: 14:16:20 GMT, February 07, 2002