is invoked as a CGI script via the history.sh CGI wrapper.
It is passed a QUERY_STRING environment variable with the
HISTFILE (a Xymon service history file)
ENTRIES (the number of entries to show)
The following non-standard parameters are handled by the
Xymon version of history.cgi:
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)
history.cgi analyses the service history file for changes that have
occurred within the past 24 hours, and build a colorbar
showing the status of the service over this period of time.
A statistics summary is also produced, listing the amount
of time for each status (green, yellow, red, purple, blue, clear).
Finally, a summary of the last N events is given, with links to
the actual event logs.
Unlike the standard history.sh script, history.cgi provides
a colorbar and statistics summaries also covering the past
1 week, 4 weeks and 1 year of data. Via links it is possible
to browse the entire history of the service at the requested
Note that since the resolution of the display is limited,
events may be too short to show up on a colorbar; also,
the exact placement of an event may not fully match up
with the time-markers.
The graphs should correctly handle the display of months
with different number of days, as well as the display of
periods that involve beginning and end of Daylight Savings
Time, if this occurs in your timezone.
All dates and times shown are in local time for the timezone
defined on the Xymon server.