Provided by: hobbit_4.2.0.dfsg-12_i386 bug


       trimhistory - Remove old Hobbit history-log entries


       trimhistory --cutoff=TIME [options]


       The  trimhistory  tool  is  used  to  purge old entries from the Hobbit
       history logs. These logfiles accumulate information  about  all  status
       changes  that  have occurred for any given service, host, or the entire
       Hobbit system, and is used  to  generate  the  event-  and  history-log

       Purging old entries can be done while Hobbit 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 Hobbit 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 Hobbit status.


              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"‘

              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.

              Causes trimhistory to delete files from services  that  are  not
              currently  tracked by Hobbit. Normally these files would be left
              untouched if only the host exists.

              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.

              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.

              Loads   the   environment   from   FILENAME   before   executing

              Enable debugging output.


              The eventlog of all events that have happened in Hobbit.

              The per-host eventlogs.

              The per-service eventlogs.

              The historical status-logs.


       BBHIST The directory holding all history logs.

              The  top-level   directory   for   the   historical   status-log

              The location of the bb-hosts file, holding the list of currently
              known hosts in Hobbit.


       hobbit(7), bb-hosts(5)