diff --git a/plugins/nginx/nginx_error b/plugins/nginx/nginx_error index 4b22081e..73f77b07 100755 --- a/plugins/nginx/nginx_error +++ b/plugins/nginx/nginx_error @@ -7,21 +7,27 @@ nginx error - Munin plugin to monitor nginx error rates (http status codes per minute). + =head1 APPLICABLE SYSTEMS -Any Linux host, running nginx, with bash version > 4.0 +Any host running nginx, with bash version > 4.0 + =head1 CONFIGURATION This shows the default configuration of this plugin. You can override the log file path and the logpattern. +Additionally you may want to adjust 'group' (or 'user') based on the +permissions required for reading the log file. [nginx_error] + group adm env.logpath /var/log/nginx env.logpattern a.*.log Nginx must also be configured to log accesses in "combined" log format (default) + =head1 USAGE Link this plugin to /etc/munin/plugins/ and restart the munin-node. @@ -33,19 +39,25 @@ will parse the log file /var/log/nginx/a.mydomaincom.log You can change 'env.logpattern' using asterisk ('*') to match your logs filenames. +'env.logpattern' is ignored for a non-symlink configuration. + + =head1 INTERPRETATION The plugin shows nginx http "error" status rates by parsing access log. + =head1 MAGIC MARKERS #%# family=auto #%# capabilities=autoconf + =head1 BUGS None known. + =head1 VERSION 1.1 - 2018/01/20 @@ -60,6 +72,7 @@ None known. vovansystems@gmail.com, 2013 + =head1 LICENSE GPLv3 @@ -122,7 +135,7 @@ do_config () { echo "graph_vlabel pages with http error codes / \${graph_period}" echo "graph_category webserver" echo "graph_period minute" - echo "graph_info This graph shows nginx error amount per minute" + echo "graph_info This graph shows nginx error rate per minute" for status_code in "${!http_codes[@]}"; do echo "error${status_code}.type DERIVE" echo "error${status_code}.min 0"