1 |
<TMPL_INCLUDE header.tmpl> |
2 |
<h1><TMPL_VAR title></h1> |
3 |
|
4 |
<div class="contents"> |
5 |
<div class="index"> |
6 |
<p class="welcome">Welcome to <TMPL_VAR HTTP_HOST>.</p> |
7 |
|
8 |
<table border="0"><tr><td valign="top" width="50%"> |
9 |
<ul> |
10 |
<li><a href="<TMPL_VAR self_url>?template=by_host.tmpl">Browse by host</a> - overview of all monitored hosts</li> |
11 |
<li><a href="<TMPL_VAR self_url>?template=list_hosts.tmpl">List of hosts</a> - list of all monitored hosts</li> |
12 |
<li><a href="<TMPL_VAR self_url>?template=by_graph.tmpl">Browse by graph</a> - overview of all monitors</li> |
13 |
<li><a href="<TMPL_VAR self_url>?template=list_graphs.tmpl">List of graphs</a> - list of all monitors</li> |
14 |
</ul> |
15 |
</td><td valign="top" width="50%"> |
16 |
<ul> |
17 |
<li><a href="<TMPL_VAR self_url>?template=by_graph.tmpl&LIKE=connections|state|loadavg|cpu_util|mem|net_traffic_eth">View most popular graphs</a></li> |
18 |
<li><a href="<TMPL_VAR self_url>?template=by_graph.tmpl&LIKE=cpu_">View all CPU graphs</a></li> |
19 |
<li><a href="<TMPL_VAR self_url>?template=by_graph.tmpl&LIKE=net_traffic_">View all network traffic graphs</a></li> |
20 |
<li><a href="<TMPL_VAR self_url>?template=by_graph.tmpl&LIKE=mem_">View all memory usage graphs</a></li> |
21 |
<li><a href="<TMPL_VAR self_url>?template=by_graph.tmpl&LIKE=apache_">View all Apache graphs</a></li> |
22 |
<li><a href="<TMPL_VAR self_url>?template=by_graph.tmpl&LIKE=_temp">View all temperate graphs</a></li> |
23 |
</ul> |
24 |
</td></tr></table> |
25 |
|
26 |
<div class="index_introduction"> |
27 |
<p> |
28 |
If you would like your server to be monitored by <TMPL_VAR HTTP_HOST>, you will |
29 |
need to download a copy of the data gathering client script (rrd-client.pl). |
30 |
<a href="/rrd-client.pl">Click here to download a copy of rrd-client.pl</a>. rrd-client.pl |
31 |
currently works best on Linux 2.6 installs or higher, but will does have limited |
32 |
support for Linux 2.4 distributions, BSD, Darwin and Solaris. Cross platform |
33 |
support will improve over time. To get the best results by monitoring as much |
34 |
as possible, you should make sure that you have the following programs installed: |
35 |
|
36 |
<br /><br /> |
37 |
<table border="0" cellspacing="0" cellpadding="0"><tr> |
38 |
<td align="left" valign="top" style="padding-right: 30px;"> |
39 |
<ul> |
40 |
<li>/usr/bin/iostat - Monitors hard disk IO</li> |
41 |
<li>/usr/bin/vmstat - Monitors CPU utilisation</li> |
42 |
<li>/usr/bin/sensors - Monitor CPU temperature</li> |
43 |
<li>/usr/bin/hddtemp - Monitor hard disk temperature</li> |
44 |
</ul> |
45 |
</td> |
46 |
<td align="left" valign="top" style="background: #eeeeff; padding: 2px 6px 4px 6px;"> |
47 |
Tree-hugging Debian & Ubuntu users can install these using:<br /> |
48 |
<code>sudo apt-get install sysstat hddtemp lm-sensors procps</code><br /><br /> |
49 |
Clever-clogs Fedora, RedHat & CentOS users can install these using:<br /> |
50 |
<code>yum install sysstat hddtemp lm-sensors procps</code> |
51 |
</td> |
52 |
</tr></table> |
53 |
<br /> |
54 |
|
55 |
Once you have downloaded rrd-client.pl and tested that it generates output, (try |
56 |
running: <code> wget -O - -q http://<TMPL_VAR HTTP_HOST>/rrd-client.pl | perl -w</code> to |
57 |
see if rrd-client.pl will work on your system without actually installing it on |
58 |
disk) you should add it to your crontab to HTTP POST the data to our server run |
59 |
every 4 or 5 minutes. A typical crontab entry might be:<br /><br /> |
60 |
|
61 |
<code><span class="tooltip">*/4<span>If you are not using a Vixie complaint |
62 |
cron daemon, or which to offset execution another minute, you may wish to |
63 |
use the following instead:<br />1,6,11,16,21,26,31,36,41,46,51,56</span></span> |
64 |
* * * * <span class="tooltip">sleep 10;<span>By delaying the execution |
65 |
of your rrd-client.pl script until 10 seconds after the minute, you will help |
66 |
avoid taking misrepresentative elevated data samples due to spawning |
67 |
cron tasks that happen on the minute.</span></span> /usr/local/bin/rrd-client.pl |
68 |
-q -p http://<TMPL_VAR HTTP_HOST>/cgi-bin/rrd-server.cgi >/dev/null</code> |
69 |
</p> |
70 |
|
71 |
<p> |
72 |
<b>To setup your own RRD::Simple Monitoring server, download the |
73 |
latest version of <a href="http://search.cpan.org/~nicolaw/RRD-Simple/">RRD::Simple</a> |
74 |
(version 1.44 or higher), and follow |
75 |
<a href="<TMPL_VAR self_url>?template=instructions.tmpl">these instructions</a>. |
76 |
You can find the very latest version of the RRD::Simple Monitoring software that |
77 |
is in live use on <TMPL_VAR HTTP_HOST>, |
78 |
<a href="http://<TMPL_VAR HTTP_HOST>/rrd-simple-monitoring.tar.gz">here</a>.</b> |
79 |
</p> |
80 |
|
81 |
<p> |
82 |
<em>If you like this software, why not show your appreciation by sending the |
83 |
author something nice from her |
84 |
<a href="http://www.amazon.co.uk/gp/registry/1VZXC59ESWYK0?sort=priority">Amazon wishlist</a>?</em> |
85 |
</p> |
86 |
</div> |
87 |
</div> |
88 |
</div> |
89 |
|
90 |
<TMPL_INCLUDE footer.tmpl> |