1 |
This is collection of cricket modules which use ssh to acquire data from |
2 |
remote hosts with minimal or no installation on monitored host. |
3 |
|
4 |
non-interactive login on remote host and execute different command |
5 |
according to identity file. |
6 |
|
7 |
Most documentation is included on top of perl file. There are also |
8 |
example Default and target files in respective directories in distribution. |
9 |
You will have to edit Default files if your installation is not in |
10 |
/data/cricket. |
11 |
|
12 |
|
13 |
maillog |
14 |
------ |
15 |
|
16 |
Install parse_maillog.pl on target host and ssh to get data in cricket. |
17 |
You will have to change some parameters in script: |
18 |
$log to point to your mail.log location if you don't want to |
19 |
give log as fist parameter in command line (recommended) |
20 |
$domain to your local domain (so that you can separate incoming |
21 |
and outgoing e-mail in graph) |
22 |
$delta (by default /var/tmp), location of temp file which will |
23 |
store current offset in mail.log -- you should create |
24 |
that file under user which will run parse_maillog.pl |
25 |
or you risk race bug by malicious user |
26 |
|
27 |
|
28 |
iptraf |
29 |
------ |
30 |
|
31 |
This module is based on work of Eric Wong <eric@taedium.net> available at |
32 |
http://www.taedium.net/rrd-iptraf/. You will have to install parse_iptraf.pl |
33 |
on target host and edit: |
34 |
@PORTS array if you want to monitor something else too (have in |
35 |
mind that you will have to edit iptraf/Defaults also if |
36 |
you change @PORTS!) |
37 |
$log - only if you don't intend to give parse_iptraf.pl log as |
38 |
parameter (I recommend that) |
39 |
$delta - to move offset file somewhere else than /var/tmp |
40 |
|
41 |
You will also have to setup iptraf to monitor traffic in 5 minute intervals. |
42 |
Do that from courses interface and start iptraf with |
43 |
# iptraf -s eth0 -B |
44 |
For detailed information about iptraf setup see |
45 |
http://www.taedium.net/rrd-iptraf/. |
46 |
Since you are NOT going to use rrdtool directly (cricket will call it for |
47 |
you) you can ignore rest of instructions. |
48 |
|
49 |
|
50 |
bind9 |
51 |
----- |
52 |
|
53 |
You should configure your bind9 on target host as described in |
54 |
README.bind9stat. Then configure parameters on top of script or |
55 |
use command line parameters. |
56 |
|
57 |
|
58 |
df |
59 |
-- |
60 |
|
61 |
You don't need to install anything on destination host (other than |
62 |
authorized_keys). I recommend that you use command 'df -Pl' to display df |
63 |
output in format which parse_df.pl understands and to display only local |
64 |
file systems (tested on Linux, HP-UX and Digital Unix). |
65 |
|
66 |
This module will use CPAN perl module Cache::FileCache if available to |
67 |
provide caching (which means that it will connect to each host just once |
68 |
to fetch all disk information). Since you have to install that module on |
69 |
your monitoring station (on which you run cricket) and NOT on target host, |
70 |
I recommend that you do so. |
71 |
|
72 |
You can also use |
73 |
$ parse_df.pl "ssh -i ~cricket/.ssh/df target.host" --config |
74 |
to create target file (with all local partition on target.host) for you. |
75 |
|
76 |
|
77 |
ntp |
78 |
--- |
79 |
|
80 |
This monitor does not require installation on target host. Just run |
81 |
$ ./parse_ntpq.pl ntp.domain --config |
82 |
to create dump target file for ntp server 'ntp.domain'. |
83 |
|
84 |
|
85 |
Most modules will create skip-overview var in target file, so that |
86 |
script generate_overview.pl will show just summary graphs. You might |
87 |
want to remove that from target files if you don't want to use |
88 |
generate_overview.pl |
89 |
|
90 |
|
91 |
generate_overview.pl |
92 |
-------------------- |
93 |
|
94 |
This script generates html pages with daily, weekly, monthly and yearly |
95 |
overview of all services and html page per service. It's currently in state |
96 |
of flux. It works, but it's not well documented and needs additional work |
97 |
(and editing of paths in it to work for you). If you use it, remember to |
98 |
change paths on top of file. |
99 |
|
100 |
|
101 |
For distribution site see https://www.rot13.org/~dpavlin/sysadm.html |
102 |
(there is also ChangeLog and CVS repository there). |
103 |
|