About

PyMunin Multigraph Munin Plugin for monitoring Nginx Web Server.

The web server status page handler must be configured and it must be accesible through the web server.

Multigraph Plugin: Yes
Multi-instance Plugin: Yes

Graphs

The plugin implements the following graphs:

  • nginx_activeconn

  • nginx_connections

  • nginx_requests

  • nginx_requestsperconn

Configuration

Configuration variables are passed to the Munin Plugins using environment variables. The environment variables for plugins are usually set in the plugin configuration files in the folder: /etc/munin/plugin-conf.d

The configuration variables implemented by the plugin are listed in the following table:

Variable Description
host Nginx Web Server Host.
(Default: 127.0.0.1)
port Nginx Web Server Port
(Default: 80, SSL: 443)
user User in case authentication is required for access to server-status page.
password Password in case authentication is required for access to server-status page.
statuspath Path for Nginx Web Server Status Page.
(Default: server-status)
ssl Use SSL if yes.
(Default: no)
samples Number of samples to collect for calculating running averages.
(Six samples for 30 minute running average are stored by default.)
include_graphs Comma separated list of enabled graphs.
(All graphs enabled by default.)
exclude_graphs Comma separated list of disabled graphs.

Additionally the following configuration variables are implemented by the plugin for Multi Instance support:

Variable Description
instance_name Name of instance.
instance_label Graph title label for instance. (Default is the same as instance name.)
instance_label_format Controls how the instance label will be added to the graph title:
  • suffix (Default)
  • prefix
  • none

Credits

Nginx Web Server Plugin ( nginxstats ) has been developed by Ali Onur Uyar ([aouyar @ GitHub] (https://github.com/aouyar)).

License

Nginx Web Server Plugin ( nginxstats ) is copyrighted free software made available under the terms of the GPL License Version 3 or later.

See the file COPYING that acompanies the code for full licensing information.