rrd-simple-monitoring/cgi-bin/index.tmpl

<TMPL_INCLUDE header.tmpl>
<h1><TMPL_VAR title></h1>

<div class="contents">
  <div class="index">
  <p class="welcome">Welcome to <TMPL_VAR HTTP_HOST>.</p>

  <table border="0"><tr><td valign="top" width="50%">
    <ul>
      <li><a href="<TMPL_VAR self_url>?template=by_host.tmpl">Browse by host</a> - overview of all monitored hosts</li>
      <li><a href="<TMPL_VAR self_url>?template=list_hosts.tmpl">List of hosts</a> - list of all monitored hosts</li>
      <li><a href="<TMPL_VAR self_url>?template=by_graph.tmpl">Browse by graph</a> - overview of all monitors</li>
      <li><a href="<TMPL_VAR self_url>?template=list_graphs.tmpl">List of graphs</a> - list of all monitors</li>
    </ul>
  </td><td valign="top" width="50%">
    <ul>
      <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>
      <li><a href="<TMPL_VAR self_url>?template=by_graph.tmpl&LIKE=cpu_">View all CPU graphs</a></li>
      <li><a href="<TMPL_VAR self_url>?template=by_graph.tmpl&LIKE=net_traffic_">View all network traffic graphs</a></li>
      <li><a href="<TMPL_VAR self_url>?template=by_graph.tmpl&LIKE=mem_">View all memory usage graphs</a></li>
      <li><a href="<TMPL_VAR self_url>?template=by_graph.tmpl&LIKE=apache_">View all Apache graphs</a></li>
      <li><a href="<TMPL_VAR self_url>?template=by_graph.tmpl&LIKE=_temp">View all temperate graphs</a></li>
    </ul>
  </td></tr></table>

  <div class="index_introduction">
  <p>
    If you would like your server to be monitored by <TMPL_VAR HTTP_HOST>, you will
    need to download a copy of the data gathering client script (rrd-client.pl).
    <a href="/rrd-client.pl">Click here to download a copy of rrd-client.pl</a>. rrd-client.pl
    currently works best on Linux 2.6 installs or higher, but will does have limited
    support for Linux 2.4 distributions, BSD, Darwin and Solaris. Cross platform
    support will improve over time. To get the best results by monitoring as much
    as possible, you should make sure that you have the following programs installed:

    <br /><br />
    <table border="0" cellspacing="0" cellpadding="0"><tr>
      <td align="left" valign="top" style="padding-right: 30px;">
        <ul>
          <li>/usr/bin/iostat - Monitors hard disk IO</li>
          <li>/usr/bin/vmstat - Monitors CPU utilisation</li>
          <li>/usr/bin/sensors - Monitor CPU temperature</li>
          <li>/usr/bin/hddtemp - Monitor hard disk temperature</li>
        </ul>
      </td>
      <td align="left" valign="top" style="background: #eeeeff; padding: 2px 6px 4px 6px;">
        Tree-hugging Debian &amp; Ubuntu users can install these using:<br />
        <code>sudo apt-get install sysstat hddtemp lm-sensors procps</code><br /><br />
        Clever-clogs Fedora, RedHat &amp; CentOS users can install these using:<br />
        <code>yum install sysstat hddtemp lm-sensors procps</code>
      </td>
    </tr></table>
    <br />

    Once you have downloaded rrd-client.pl and tested that it generates output, (try
    running: <code> wget -O - -q http://<TMPL_VAR HTTP_HOST>/rrd-client.pl | perl -w</code> to
    see if rrd-client.pl will work on your system without actually installing it on
    disk) you should add it to your crontab to HTTP POST the data to our server run
    every 4 or 5 minutes. A typical crontab entry might be:<br /><br />

    <code><span class="tooltip">*/4<span>If you are not using a Vixie complaint
      cron daemon, or which to offset execution another minute, you may wish to
      use the following instead:<br />1,6,11,16,21,26,31,36,41,46,51,56</span></span>
      * * * * <span class="tooltip">sleep 10;<span>By delaying the execution
      of your rrd-client.pl script until 10 seconds after the minute, you will help
      avoid taking misrepresentative elevated data samples due to spawning
      cron tasks that happen on the minute.</span></span> /usr/local/bin/rrd-client.pl
       -q -p http://<TMPL_VAR HTTP_HOST>/cgi-bin/rrd-server.cgi >/dev/null</code>
  </p>

  <p>
    <b>To setup your own RRD::Simple Monitoring server, download the
    latest version of <a href="http://search.cpan.org/~nicolaw/RRD-Simple/">RRD::Simple</a>
    (version 1.44 or higher), and follow
    <a href="<TMPL_VAR self_url>?template=instructions.tmpl">these instructions</a>.
    You can find the very latest version of the RRD::Simple Monitoring software that
    is in live use on <TMPL_VAR HTTP_HOST>,
    <a href="http://<TMPL_VAR HTTP_HOST>/rrd-simple-monitoring.tar.gz">here</a>.</b>
  </p>

  <p>
    <em>If you like this software, why not show your appreciation by sending the
    author something nice from her
    <a href="http://www.amazon.co.uk/gp/registry/1VZXC59ESWYK0?sort=priority">Amazon wishlist</a>?</em>
  </p>
  </div>
  </div>
</div>

<TMPL_INCLUDE footer.tmpl>
1	dpavlin	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>