Section: Maintenance Commands (8)
Updated: Version 4.3.28: 17 Jan 2017
Return to Main Contents
xymond_history - xymond worker module for logging status changes
xymond_channel --channel=stachg xymond_history [options]
xymond_history is a worker module for xymond, and as such it is normally
run via the
program. It receives xymond status-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.
The directory for the history files. If not specified, the
directory given by the XYMONHISTDIR environment is used.
The directory for the historical status-logs. If not specified, the
directory given by the XYMONHISTLOGS environment is used.
Sets the minimum percentage of free filesystem space on the $XYMONHISTLOGS
directory. If there is less than N% free space, xymond_history will
not save the detailed status-logs.
xymond_history writes the process-ID it is running with to this file.
This is for use in automated startup scripts. The default file is
Enable debugging output.
This environment variable controls if the $XYMONHISTDIR/allevents
logfile is updated. This file is used by the event-log display on the
nongreen html page and the eventlog-webpage, among other things.
You can disable it by setting XYMONALLHISTLOGS=FALSE, but this is not
This environment variable controls if the $XYMONHISTDIR/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
This environment variable controls if the historical
status-logs are saved whenever a status change occurs. These logfiles
are stored in the $XYMONHISTLOGS 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.
If you want to save all except some specific logs, use SAVESTATUSLOG=TRUE,!TEST1[,!TEST2...]
If you want to save none except some specific logs, use SAVESTATUSLOG=FALSE,TEST1[,TEST2...]
NOTE: Status logs will not be saved if there is less than 5% free space on
the filesystem hosting the $XYMONHISTLOGS directory. The threshold can
be tuned via the "--minimum-free" option.
This module does not rely on any configuration files.
xymond_channel(8), xymond(8), xymon(7)
- SEE ALSO
This document was created by
using the manual pages.
Time: 00:13:25 GMT, January 18, 2017