monshow - show operational status of mon server.

       Jim Trocki <trockij@arctic.org>

Linux                                     $Date: 2005/04/17 07:42:27 $                                monshow(1)

       Report bugs to the email address below.

       If monshow is invoked with the "REQUEST_METHOD" environment variable set, then CGI invocation is assumed.
       In that case, monshow 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 equivalent.

monshow show the operational status  of  the  mon  server.  Both  command-line  and  CGI  interfaces  are
       available.

       MONHOST
              The hostname of the server which runs the mon process.

       monshow - show operational status of mon server.

--help show help

       --showall
              Do not read configuration file, and show operational status of all groups and services.

       --full Instead of showing only failed services, show all services no matter the state.

       --detailgroup,service
              Display detailed information for group and service.  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.

       --viewname
              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 view name.

       --auth Authenticate client to the mon server.

       --disabled
              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.

       --serverhostname
              Connect to the mon server on host hostname.  hostname 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 MONHOST is
              used, if it exists. Otherwise, monshow will fail.

       --loginusername
              When authenticating, use username.

       --portportnum
              Connect to the server on portnum.

       --protprotocol
              Sets the protocol to protocol.  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.

       --old  Use the old 0.37 protocol and port number (32777).

       --rcfilefile
              Use configuration file file instead of ~/.monshowrc.

mon(8)

monshow  [--help]  [--showall]  [--full]  [--disabled]  [--detailgroup,service]  [--viewname] [--auth]
       [--loginuser] [--old] [--serverhostname] [--portportnum] [--protprotocol] [--rcfilefile]

       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.

       watchgroup
              Include the status of all the services for "group".

       servicegroupservice
              Include the status of the service specified by group and service.

       If  no  watch  or service configuration lines are present, then the status of all groups and services are
       displayed.

       setshow-disabled
              This has the same effect as using the --disabled option.

       sethosthostname
              Query the mon server hostname.

       setportnumber
              The TCP port which the mon server is listening on.

       setprotprotocol
              Set the protocol. This probably should not be used unless you really know what you're doing.

       setfull
              Show everything disabled, all failures, all successes, and all untested services.

       setbgcolor
              Background color for the CGI report. The value of this parameter should resemble "d5d5d5" (without
              the quotes).

       setbg-okcolor
              Background color for services which are in an "ok" state.

       setbg-failcolor
              Background color for services which are failing.

       setbg-untestedcolor
              Background color for services which have yet to be tested.

       setrefreshseconds
              For CGI output, set the frequency that the report reloads.  The default is to not reload.

       summary-lenlen
              For CGI output, set the maximum length of the  summary  output  to  display.  Summary  text  which
              exceeds len will be truncated and replaced with ellipses.

       linkgroupserviceURL
              For  the  CGI  report, make a link to URL at the bottom of the detail report for group/service for
              more information.

       link-textgroupservice
              Insert all HTML up until a line beginning with "END"  after  the  link  specified  with  the  link
              setting.

       sethtml-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.

       A  view  is  a  pre-defined  configuration  supplied to monshow.  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  /etc/mon/monshow,  where  each  file
       specifies  one  view.  If  this  path  is not suitable for any reason, it can be changed by modifying the
       $VIEWPATH variable in the monshow script.

       When invoking monshow from the command line,  the  view  to  display  is  specified  by  the  --view=name
       argument.

       In the case of CGI invocation, views can be specified by appending either ?view=name or /name to the URL.
       For example, the following are equivalent:

       http://monhost/monshow.cgi?view=testhttp://monhost/monshow.cgi/test

       If  a  view is not specified, then a default configuration will be loaded from $HOME/.monshowrc (command-
       line invocation) or cgi-path/.monshowrc (CGI invocation).