recaptool(8)

1RECAPTOOL(8)                System Manager's Manual               RECAPTOOL(8)
2
3
4

NAME

6       recaptool  - parses the logs and prints specific information about mem‐
7       ory, processes, network connections or queries to a mysql db.
8
9

SYNOPSIS

11       recaptool OPTIONS...
12
13

DESCRIPTION

15       recaptool is a parsing tool for recap logs that shows specific informa‐
16       tion  like  processes, memory, network or querycount. Useful for seeing
17       trends on a particular option in the logs.
18
19

OPTIONS

21       Note: Different options can be combined to get more information.
22
23
24       -m, --mem PROCESS_NAME
25              Shows the memory consumption for PROCESS_NAME from the logs.
26
27
28       -p, --proc PROCESS_NAME
29              Shows the amount of processes found for  PROCESS_NAME  from  the
30              logs.
31
32
33       -b, --memproc PROCESS_NAME
34              Shows both process count and memory consumption for PROCESS_NAME
35              from the logs.
36
37
38       -c, --connections PORT
39              Shows the amount of connections to PORT from the logs.
40
41
42       -e, --established PORT
43              Shows the amount of ESTABLISHED connections  to  PORT  from  the
44              logs.
45
46
47       -q, --querycount
48              Shows the amount of mysql connections from the logs.
49
50
51       -d, --path PATH
52              Overrides   the   recap   log   PATH.   Default   uses   BASEDIR
53              /var/log/recap/ (can be changed in config file).
54
55
56       -V, --version
57              Print version and exit.
58
59
60       -h, --help
61              Prints the help information and exit.
62
63

FILES

65       /var/log/recap/*.log (unless overridden by 'path' option)
66
67

EXAMPLES

69       Show the memory and amount of processes running for httpd:
70              $ sudo recaptool --memproc http
71              Information: Using /var/log/recap as recap log path
72              Information: Executing memproc http
73              2016-10-07_00:00:01     1101    3032.535 M
74              2016-10-07_00:10:01     1120    3132.832 M
75              2016-10-07_00:20:01     1128    3186.153 M
76
77
78       Show the amount of established connections on port 443:
79              $ sudo recaptool -e 443
80              Information: Using /var/log/recap as recap log path
81              Information: Executing established 443
82              2016-10-07_00:00:01     302
83              2016-10-07_00:10:01     311
84              2016-10-07_00:20:01     312
85
86
87       Show the amount of query connections to the mysql db:
88              $ sudo recaptool --querycount
89              Information: Using /var/log/recap as recap log path
90              Information: Executing querycount
91              2016-10-07_00:00:01     124
92              2016-10-07_00:10:01     125
93              2016-10-07_00:20:01     128
94
95
96       Show all of the above in a single command:
97              $ sudo recaptool --memproc http -e 443 --querycount
98              Information: Using /var/log/recap as recap log path
99              Information: Executing memproc http
100              2016-10-07_00:00:01     1101    3032.535 M
101              2016-10-07_00:10:01     1120    3132.832 M
102              2016-10-07_00:20:01     1128    3186.153 M
103
104              Information: Executing established 443
105              2016-10-07_00:00:01     302
106              2016-10-07_00:10:01     311
107              2016-10-07_00:20:01     312
108
109              Information: Executing querycount
110              2016-10-07_00:00:01     124
111              2016-10-07_00:10:01     125
112              2016-10-07_00:20:01     128
113
114

REPORTING BUGS

116       Bugs and issues to be submitted via github  <https://github.com/racker‐
117       labs/recap/issues>.
118
119

AUTHOR

121       The recap scripts are maintained by Rackspace, the list of contributors
122       is    available    at     https://github.com/rackerlabs/recap/blob/mas‐
123       ter/CHANGELOG.md#contributors.
124
125