hobbitd_history(8) [debian man page]

HOBBITD_HISTORY(8)					      System Manager's Manual						HOBBITD_HISTORY(8)

NAME

       hobbitd_history - hobbitd worker module for logging status changes

SYNOPSIS

       hobbitd_channel --channel=stachg hobbitd_history [options]

DESCRIPTION

       hobbitd_history is a worker module for hobbitd, and as such it is normally run via the hobbitd_channel(8) program. It receives hobbitd sta-
       tus-change messages from the "stachg" channel via stdin, and uses these to update the history logfiles in a manner that is compatible  with
       the standard Big Brother daemon, bbd.

OPTIONS

       --histdir=DIRECTORY
	      The directory for the history files. If not specified, the directory given by the BBHIST environment is used.

       --histlogdir=DIRECTORY
	      The directory for the historical status-logs. If not specified, the directory given by the BBHISTLOGS environment is used.

       --debug
	      Enable debugging output.

ENVIRONMENT

       BBALLHISTLOG
	      This  environment  variable  controls if the $BBHIST/allevents logfile is updated. This file is used by the event-log display on the
	      BB2 html page. If you do not use this, you can disable it by setting BBALLHISTLOGS=FALSE.

       BBHOSTHISTLOG
	      This environment variable controls if the $BBHIST/HOSTNAME logfile is updated. This file holds a list of all status changes seen for
	      a  single  host,	but is not used by any of the standard Xymon tools. If you do not want to save this, you can disable it by setting
	      BBHOSTHISTLOG=FALSE.

       SAVESTATUSLOG
	      This environment variable controls if the historical status-logs are saved whenever a  status  change  occurs.  These  logfiles  are
	      stored  in the $BBHISTLOGS directory, and are used for the detailed log-display of a status from the Xymon "History" page. If you do
	      not want to save these, you can disable it by setting SAVESTATUSLOG=FALSE.

FILES

       This module does not rely on any configuration files.

SEE ALSO

       hobbitd_channel(8), hobbitd(8), xymon(7)

Xymon							    Version 4.2.3:  4 Feb 2009						HOBBITD_HISTORY(8)

BB-HOSTSVC.CGI(1)					      General Commands Manual						 BB-HOSTSVC.CGI(1)

NAME

       hobbitsvc.cgi - CGI program to view Xymon status logs

SYNOPSIS

       hobbitsvc.cgi [--hobbitd|--historical] [--history={top|bottom}]

DESCRIPTION

       hobbitsvc.cgi is a CGI program to present a Xymon status log in HTML form (ie, as a web page). It can be used both for the logs showing the
       current status, and for historical logs from the "histlogs" directory. It is normally invoked as a CGI program, and therefore receives most
       of the input parameters via the CGI QUERY_STRING environment variable.

       Unless the "--historical" option is present, the current status log is used. This assumes a QUERY_STRING environment variable of the form
	  HOSTSVC=hostname.servicename
       where  "hostname"  is  the  name  of the host with commas instead of dots, and "servicename" is the name of the service (the column name in
       Xymon).	Such links are automatically generated by the bbgen(1) tool when the environment contains "BBLOGSTATUS=dynamic".

       With the "--historical" option present, a historical logfile is used. This assumes a QUERY_STRING environment variable of the form
	  HOST=hostname&SERVICE=servicename&TIMEBUF=timestamp
       where "hostname" is the name of the host with commas instead of dots, "servicename" is the name of the service, and "timestamp" is the time
       of the log. This is automatically generated by the bb-hist.cgi(1) tool.

OPTIONS

       --hobbitd
	      Retrieve	the  current status log from hobbitd(1) rather than from the logfile. This is for use with the Xymon daemon from the Xymon
	      monitor version 4.

       --historical
	      Use a historical logfile instead of the current logfile.

       --history={top|bottom|none}
	      When showing the current logfile, provide a "HISTORY" button at the top or the bottom of the webpage, or not at all. The default	is
	      to put the HISTORY button at the bottom of the page.

       --env=FILENAME
	      Load the environment from FILENAME before executing the CGI.

       --templates=DIRECTORY
	      Where to look for the HTML header- and footer-templates used when generating the webpages. Default: $BBHOME/web/

       --no-svcid
	      Do  not  include	the  HTML  tags  to identify the hostname/service on the generated web page. Useful is this already happens in the
	      hostsvc_header template file, for instance.

       --multigraphs=TEST1[,TEST2]
	      This causes hobbitsvc.cgi to generate links to service graphs that are split up into multiple images, with  at  most  5  graphs  per
	      image. This option only works in Xymon mode. If not specified, only the "disk" status is split up this way.

       --no-disable
	      By default, the info-column page includes a form allowing users to disable and re-enable tests. If your setup uses the default sepa-
	      ration of administration tools into a separate, password- protected area, then use of the  disable-  and	enable-functions  requires
	      access to the administration tools. If you prefer to do this only via the dedicated administration page, this option will remove the
	      disable-function from the info page.

       --no-jsvalidation
	      The disable-function on the info-column page by default uses JavaScript to validate the form before  submitting  the  input  to  the
	      Xymon server. However, some browsers cannot handle the Javascript code correctly so the form does not work. This option disables the
	      use of Javascript for form-validation, allowing these browsers to use the disable-function.

FILES

       $BBHOME/web/hostsvc_header
	      HTML template header

       $BBHOME/web/hostsvc_footer
	      HTML template footer

ENVIRONMENT

       NONHISTS=info,trends,graphs
	      A comma-separated list of services that does not have meaningful history, e.g. the "info" and "trends" columns. Services listed here
	      do not get a "History" button.

       TEST2RRD=test,test
	      A comma-separated list of the tests that have an RRD graph.

SEE ALSO

       xymon(7), hobbitd(1)

Xymon							    Version 4.2.3:  4 Feb 2009						 BB-HOSTSVC.CGI(1)