NAME
trimhistory - Remove old Xymon history-log entries
SYNOPSIS
trimhistory --cutoff=TIME [options]
DESCRIPTION
The trimhistory tool is used to purge old entries from the Xymon
history logs. These logfiles accumulate information about all status
changes that have occurred for any given service, host, or the entire
Xymon system, and is used to generate the event- and history-log
webpages.
Purging old entries can be done while Xymon is running, since the tool
takes care not to commit updates to a file if it changes mid-way
through the operation. In that case, the update is aborted and the
existing logfile is left untouched.
Optionally, this tool will also remove logfiles from hosts that are no
longer defined in the Xymon bb-hosts(5) file. As an extension, even
logfiles from services can be removed, if the service no longer has a
valid status-report logged in the current Xymon status.
OPTIONS
--cutoff=TIME
This defines the cutoff-time when processing the history logs.
Entries dated before this time are discarded. TIME is specified
as the number of seconds since the beginning of the Epoch. This
is easily generated by the GNU date(1) utility, e.g. the
following command will trim history logs of all entries prior to
Oct. 1st 2004:
trimhistory --cutoff=‘date +%s --date="1 Oct 2004"‘
--outdir=DIRECTORY
Normally, files in the BBHIST directory are replaced. This
option causes trimhistory to save the shortened history logfiles
to another directory, so you can verify that the operation works
as intended. The output directory must exist.
--drop Causes trimhistory to delete files from hosts that are not
listed in the bb-hosts(5) file.
--dropsvcs
Causes trimhistory to delete files from services that are not
currently tracked by Xymon. Normally these files would be left
untouched if only the host exists.
--droplogs
Process the BBHISTLOGS directory also, and delete status-logs
from events prior to the cut-off time. Note that this can
dramatically increase the processing time, since there are often
lots and lots of files to process.
--progress[=N]
This will cause trimhistory to output a status line for every N
history logs or status-log collections it processes, to indicate
how far it has progressed. The default setting for N is 100.
--env=FILENAME
Loads the environment from FILENAME before executing
trimhistory.
--debug
Enable debugging output.
FILES
$BBHIST/allevents
The eventlog of all events that have happened in Xymon.
$BBHIST/HOSTNAME
The per-host eventlogs.
$BBHIST/HOSTNAME.SERVICE
The per-service eventlogs.
$BBHISTLOGS/*/*
The historical status-logs.
ENVIRONMENT VARIABLES
BBHIST The directory holding all history logs.
BBHISTLOGS
The top-level directory for the historical status-log
collections.
BBHOSTS
The location of the bb-hosts file, holding the list of currently
known hosts in Xymon.
SEE ALSO
xymon(7), bb-hosts(5)