table of contents
other versions
- wheezy 4.3.0~beta2.dfsg-9.1
BB-HIST.CGI(1) | General Commands Manual | BB-HIST.CGI(1) |
NAME¶
bb-hist.cgi - CGI program to display service historySYNOPSIS¶
bb-hist.cgiDESCRIPTION¶
bb-hist.cgi is invoked as a CGI script via the bb-hist.sh CGI wrapper. It is passed a QUERY_STRING environment variable with the following parameters:HISTFILE (a Xymon service history file)
ENTRIES (the number of entries to show)
IP (IP address of host - for display purposes only)
PIXELS (width of colorbar when in pixel-mode)
ENDTIME (when the colorbar begins, a time_t value)
BARSUMS (which colorbars and summaries to show)
PARAMETERS¶
- HISTFILE
- Defines the host and service whose history is presented.
- ENTRIES
- The number of log-entries to show in the event log table. Default is 50; to view all log entries set this to "ALL".
- IP
- The IP-address of the host. This is only used for the title of the document.
- PIXELS
- The width of the colorbar graph in pixels. If this is set to 0, a percentage-based graph will be shown, similar to the one provided by the standard bb-hist.sh script. Pixel-based graphs can have a higher resolution, but do not resize automatically to suit the size of a browser window. The default value for this parameter is defined at compile-time; 960 is a good value for displays with a 1024x768 resolution.
- BARSUMS
- Defines which colorbars and summaries to show. This is a number made up from a bitmask. The 1-day graph uses the value "1"; the 1-week graph uses the value "2"; the 4-week graph uses the value "4" and the 1-year graph the value "8". To show multiple graph, add the values - e.g. "6" will show the 1-week and 4-weeks graphs, whereas "15" will show all the graphs. The default is defined at compile-time.
- ENDTIME
- The history display by default ends with the current time.
Setting the ENDTIME parameter causes it to end at the time specified -
this is given as a Unix "time_t" value, i.e. as the number of
seconds elapsed since Jan 1 1970 00:00 UTC.
OPTIONS¶
- --env=FILENAME
- Load the environment from FILENAME before executing the
CGI.
SEE ALSO¶
bb-hosts(5), hobbitserver.cfg(5)Version 4.2.3: 4 Feb 2009 | Xymon |