FAQ

Page Discussion History

Difference between revisions of "HttpStubStatusModule"

(stub_status)
(Collectd.org)
 
Line 54: Line 54:
 
* [http://github.com/perusio/nginx-munin Nginx Munin plugins on Github with howto instructions]
 
* [http://github.com/perusio/nginx-munin Nginx Munin plugins on Github with howto instructions]
 
* [http://aouyar.github.com/PyMunin/ 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.
 
* [http://aouyar.github.com/PyMunin/ 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.
 +
* [https://collectd.org/wiki/index.php/Plugin:nginx Collectd - high-resolution RRD statistics client-server software]

Latest revision as of 21:55, 14 April 2013

Contents

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 configure 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

active connections -- number of all open connections including connections to backends

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

reading -- nginx reads request header

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

waiting -- keep-alive connections, actually it is active - (reading + writing)

References