Section: Maintenance Commands (8)Updated: Version 4.2.3: 4 Feb 2009Local indexUp
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.