You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

37 lines
1.9 KiB
HTML

<h1>Monitoring plugin for Apache with mod_watch</h1>
<br>Collects request and document counts.
<br>Plugin supports <a href="https://assets.nagios.com/downloads/nagioscore/docs/nagioscore/3/en/pluginapi.html" target="_blank">Nagios</a>, <a href="https://collectd.org/wiki/index.php/Plain_text_protocol" target="_blank">Collectd</a> and <a href="https://docs.influxdata.com/influxdb/v0.13/write_protocols/line/" target="_blank">Influx Line Protocol</a> output formats.<br><br>
Requirements:<br>
- Perl interpreter<br>
- mod_watch module (patches for Apache 2.4 <a href="https://github.com/pld-linux/apache-mod_watch" target="_blank">can be found here</a>)
<br>
<h3>Example Apache config</h3>
<pre class="light-well">LoadModule watch_module libexec/apache24/mod_watch.so
<VirtualHost 127.0.0.1:8080>
<Location /watch-list>
SetHandler watch-list
</Location>
</VirtualHost></pre>
Collectd output format requires adding this line to <i>types.db</i> file:<br>
<pre class="light-well">apache docs:GAUGE:0:U, reqs:GAUGE:0:U</pre>
<h3>Plugin parameters</h3>
<pre class="light-well"><watch-list url>
[Required] watch-list URL, e.g. http://login:pass@127.0.0.1:8080/watch-list?auto
<domain.com,example.org,...>
[Required] Comma-separated list of domains to monitor (used as type-instances for collectd and as "domain" tag for influxlp)
<collectd|influxlp>
[Optional] Output format - nagios, collectd, influxlp (defaults to nagios)
<u>Collectd format:</u>
<myhost.com>
[Optional] Hostname (defaults to current system hostname)
<myplugin>
[Optional] Plugin name (defaults to apachewatch)
<300>
[Optional] Interval (defaults to 60 sec)
<u>Influx Line-Protocol format:</u>
<mymeasurement>
[Optional] Measurement name (defaults to apachewatch)</pre>
<h3>Graph example (InfluxDB + Grafana):</h3>
<img src="https://code.highspec.ru/Mikanoshi/check_apache_watch/raw/master/graph.jpg" />