Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 35 lines (29 sloc) 1.83 kB
99209b4 @danfruehauf Abstraction of interface to support future RRD monitoring systems
danfruehauf authored
1 This directory contains scripts to integrate monitis with RRD monitoring
2 systems such as munin, cacti etc.
3
4 Example for a munin installation:
5 After checking out the repository, edit monitis_config with your API key
6 and secret key as provided from the monitis interface.
7
8 Assuming your munin installation is in /var/lib/munin and your hostname
9 in munin is 'localhost', you can experiment with the following:
10 # ./monitis_rrd.sh munin list_monitors /var/lib/munin localhost
11 This will list the available monitors, each monitor will contain 1 to many
12 counters, to list them, use:
13 # ./monitis_rrd.sh munin list_monitors /var/lib/munin localhost memory
14 This will list the counters the monitor 'memory' provides
15
16 In order to add a munin memory monitor with the counters 'free' and 'active'
17 you can run the following:
18 # ./monitis_rrd.sh munin add_monitor /var/lib/munin localhost memory free active
19 You can now make sure in the monitis interface that the monitor and counters
20 were added and then we can try to update the data the counters hold:
21 # ./monitis_rrd.sh munin update_data_for_monitor /var/lib/munin localhost memory free active
22 If the counters are updated, we can try and hook it via crontab.
23
24 Munin by default is configured to run every 5 minutes, in most fedoras we can
25 find it in /etc/cron.d/munin:
26 */5 * * * * munin test -x /usr/bin/munin-cron && /usr/bin/munin-cron
27 This can work with our example in example/munin_hook_example.sh, change the
28 above line to call the hook script:
aca9f93 @danfruehauf Fixed example
danfruehauf authored
29 */5 * * * * munin test -x /usr/bin/munin-cron && /usr/bin/munin-cron && /usr/share/monitis/RRD/munin_hook_example.sh
99209b4 @danfruehauf Abstraction of interface to support future RRD monitoring systems
danfruehauf authored
30 This will call the script and will update the counters every time munin
31 finishes to run so we have fresh new RRD data to update.
32
33 Please note that monitor and counter creation should happen before hooking the
34 script.
Something went wrong with that request. Please try again.