NAME

       recap - dumps periodic information about running applications and resource usage

SYNOPSIS

       recap [OPTION]

DESCRIPTION

       recap  is  a  user-configurable  script  that  can  be  run  once,  or  run  periodically  out of cron or
       systemd.timers to dump information about running processes and resource usage.  It's  useful  on  servers
       that  have  periodic, mysterious performance anomalies for tracking down what may be going on at the time
       of any particular incident.

       The values for which reports are generated  and  how  many  reports  are  stored  can  be  overridden  in
       /etc/recap.conf.  The output files from the script are written to BASEDIR.

       -B, --backup
              This  will  perform  a  "backup". It will copy the latest log files from the last execution to the
              "backups" directory inside BASEDIR. The files will be identified by a timestamp in the name.

       -S, --snapshot
              This will perform a "snapshot" report. It will generate a set of output files  in  the  "snapshot"
              directory  inside  BASEDIR  outside  of  the  standard rotation. The files will be identified by a
              timestamp in the name.

       -V, --version
              Print version and exit.

       FILES
              /etc/recap.conf
              /etc/cron.d/recap
              /usr/lib/systemd/system/recap.{service,timer} - Unit files for running recap periodically.
              /usr/lib/systemd/system/recap-onboot.{service,timer} - Unit files for running recap on boot.

REPORTING BUGS

       Bugs and issues to be submitted via github <https://github.com/rackerlabs/recap/issues>.

AUTHOR

       The  recap  scripts  are  maintained  by  Rackspace,  the  list   of   contributors   is   available   at
       https://github.com/rackerlabs/recap/blob/master/CHANGELOG.md#contributors.

SEE ALSO

       recap.conf(5), recaplog(8), crontab(5), systemd.timer(5)

                                                  Aug 18, 2017                                          RECAP(8)