HttpStubStatusModule

= Synopsis = This module provides the ability to get some status from nginx.

This module is not compiled by default and must be specified using the --with-http_stub_status_module argument to  when compiling Nginx.

Example: location /nginx_status { # copied from http://blog.kovyrin.net/2006/04/29/monitoring-nginx-with-rrdtool/ stub_status on; access_log  off; allow SOME.IP.ADD.RESS; deny all; }

= Directives =

stub_status
syntax: stub_status on

default: None

context: location

Enables the status handler in this location.

The stub status module reports status similar to mathopd's status page. It is plain text information like Active connections: 291 server accepts handled requests 16630948 16630948 31070465 Reading: 6 Writing: 179 Waiting: 106

-- number of all open connections including connections to backends

-- nginx accepted 16630948 connections, handled 16630948 connections (no one was closed just it was accepted), and handles 31070465 requests (1.8 requests per connection)

-- nginx reads request header

-- nginx reads request body, processes request, or writes response to a client

-- keep-alive connections, actually it is

= References =
 * Monitoring Nginx with RRDtool
 * RRDtool README
 * Munin Plugin Exchange (containing plugins for Nginx)
 * Nginx Munin plugins on Github with howto instructions
 * PyMunin - Multigraph Munin Plugins in Python - PyMunin includes a Multigraph Munin Plugin for monitoring Nginx using http_stub_status module. Graphs active connections, connection rate, request rate and average requests per connection.
 * Collectd - high-resolution RRD statistics client-server software