Repository
Munin (contrib)
Last change
2020-10-06
Graph Categories
Capabilities
Keywords
Language
Bash
Authors

vhost_requests_

Name

vhost_requests_ - Wildcard-plugin to monitor http requests by response status code to a particular virtual host.

Configuration

Example configuration follows.

[vhost_requests_*]
  user root

Or you can just give read access to munin.

An example way to create links for all logfiles (remove the \ from the \$s): for f in \$(ls /var/log/apache2/*access_log) ; do ln -s /usr/share/munin/plugins/vhost_requests_ vhost_requests_\$(basename \$f); done

Also refer to max_lines, logdir, date_format and status_column below if you have any issue, if you’re on fedora you’ll need to change at least logdir.

Environment Variables

This plugin does not use environment variables

Wildcard Plugin

This is a wildcard plugin. To show requests by response status code on a particular virtual host, link vhost_requests_<desired_access_log_filename> to this file.

E.g.

ln -s /usr/share/munin/plugins/vhost_requests_ /etc/munin/plugins/vhost_requests_host.org-access_log

Author

Roberto Rodriguez

#!/bin/bash
# -*- sh -*-

: <<END

=head1 NAME

vhost_requests_ - Wildcard-plugin to monitor http requests by response status code to a particular virtual host.

=head1 CONFIGURATION

Example configuration follows.

  [vhost_requests_*]
    user root

Or you can just give read access to munin.

An example way to create links for all logfiles (remove the \ from the \$s):
for f in \$(ls /var/log/apache2/*access_log) ; do ln -s /usr/share/munin/plugins/vhost_requests_ vhost_requests_\$(basename \$f); done

Also refer to max_lines, logdir, date_format and status_column below if you have any issue, if
you're on fedora you'll need to change at least logdir.

=head2 ENVIRONMENT VARIABLES

This plugin does not use environment variables

=head2 WILDCARD PLUGIN

This is a wildcard plugin.  To show requests by response status code
on a particular virtual host, link vhost_requests_<desired_access_log_filename> to this file.

E.g.

 ln -s /usr/share/munin/plugins/vhost_requests_ /etc/munin/plugins/vhost_requests_host.org-access_log

=head1 AUTHOR

Roberto Rodriguez

=cut
END

# This is the format that date will use to generate access_log like entries
date_format='+%d/%b/%Y:%R'
# This is where apache stores logfiles
logdir=/var/log/apache2

# By default process the whole logfile, but you can set a value different than 0 to limit the lines to process.
# This is useful if the plugin is hurting your performance, a way to calculate this could be:
# The expected requests in five minutes (you can grab this from the maximum value in the y legend)
# / 5 * 6 (Because we left the last minute to the next round)
# times how high can an unexpected peak be (Example 3 times)
# So, if we have 1000 requests every five minutes max_lines could be:
# 1000 / 5 * 6 * 3 = 3600
# It should improve performance because at 1000 requests per 5 minutes you have 288000 per day but it will only read 3600 each time.
max_lines=0
# If your http status code comes in a different column, you can change it here: (Assuming ' ' is the column separator)
status_column=9

file_name=`basename $0 | sed 's/^vhost_requests_//g'`

case $1 in
   config)
echo graph_category webserver
echo graph_title Requests by Status Code $file_name
echo graph_vlabel Nr of Requests
echo S200.label 200 OK
echo S206.label 206 Partial Content
echo S301.label 301 Moved Permanently
echo S302.label 302 Found
echo S303.label 303 See Other
echo S304.label 304 Not Modified
echo S400.label 400 Bad Request
echo S403.label 403 Forbidden
echo S404.label 404 Not Found
echo S405.label 405 Method Not Allowed
echo S500.label 500 Internal Server Error
echo S502.label 502 Bad Gateway
echo S503.label 503 Service Unavailable
echo S200.draw AREA
echo S206.draw STACK
echo S301.draw STACK
echo S302.draw STACK
echo S303.draw STACK
echo S304.draw STACK
echo S400.draw STACK
echo S403.draw STACK
echo S404.draw STACK
echo S405.draw STACK
echo S500.draw STACK
echo S502.draw STACK
echo S503.draw STACK
        exit 0;;
esac

if [ $max_lines -eq 0 ]
then
	for f in $(seq 5); do grep $(date $date_format -d "-$f min") $logdir/$file_name; done | cut -d' ' -f $status_column | sort | uniq -c | awk '{ print "S"$2".value "$1; }'
else
	for f in $(seq 5); do tail -n $max_lines $logdir/$file_name | grep $(date $date_format -d "-$f min"); done | cut -d' ' -f $status_column | sort | uniq -c | awk '{ print "S"$2".value "$1; }'
fi