recaptool man page

recaptool — parses the logs and prints specific information about memory, processes, network connections or queries to a mysql db.

Synopsis

recaptool {proc|mem|procmen} PROCESS_NAME

recaptool {net|netestab} PORT

recaptool querycount

recaptool -d PATH

recaptool -V, --version

Description

recaptool  is a parsing tool for recap logs that shows specific information like processes, memory, network or querycount. Useful for seeing trends on a particular option in the logs.

Options

mem PROCESS_NAME

Shows the memory consumption for PROCESS_NAME from the logs.

proc PROCESS_NAME

Shows the amount of processes found for PROCESS_NAME from the logs.

procmem PROCESS_NAME

Shows both(process and memory) for PROCESS_NAME from the logs.

net PORT

Shows the amount of connections to PORT from the logs.

netestab PORT

Shows the amount of ESTABLISHED connections to PORT from the logs.

querycount

Shows the amount of mysql connections from the logs.

-d PATH

Overrides the recap log PATH. Default uses BASEDIR /var/log/recap/ Can be changed in config file.

-V, --version

Print version and exit.

Files

/var/log/recap/*.log

Examples

Show the memory and amount of processes running for httpd:
$ sudo recaptool memproc http
Information: Using /var/log/recap as recap log path
Information: Executing memproc http
2016-10-07_00:00:01     1101    3032.535 M
2016-10-07_00:10:01     1120    3132.832 M
2016-10-07_00:20:01     1128    3186.153 M
Show the amount of established connections on port 443:
$ sudo recaptool netestab 443
Information: Using /var/log/recap as recap log path
Information: Executing netestab 443
2016-10-07_00:00:01     302
2016-10-07_00:10:01     311
2016-10-07_00:20:01     312
Show the amount of query connections to the mysql db:
$ sudo recaptool querycount
Information: Using /var/log/recap as recap log path
Information: Executing querycount
2016-10-07_00:00:01     124
2016-10-07_00:10:01     125
2016-10-07_00:20:01     128

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(5), recap(8),

Info

Aug 18, 2017