HttpStubStatusModule - Revision history

Ser: Collectd.org

2013-04-14T21:55:10Z

Collectd.org

Yaoweibin: /* stub_status */

2012-05-21T03:57:48Z

‎stub_status

Aouyar: /* References */

2011-11-27T21:51:45Z

‎References

New page

= 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
<pre>--with-http_stub_status_module</pre>
argument to <code>configure</code> when compiling Nginx.

Example:
<pre>
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;
}
</pre>

= 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 [http://www.mathopd.org/ mathopd's] status page. It is plain text information like
<pre>
Active connections: 291
server accepts handled requests
16630948 16630948 31070465
Reading: 6 Writing: 179 Waiting: 106
</pre>

<code>active connections</code> -- number of all open connections including connections to backends

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

<code>reading</code> -- nginx reads request header

<code>writing</code> -- nginx reads request body, processes request, or writes response to a client

<code>waiting</code> -- keep-alive connections, actually it is <code>active - (reading + writing)</code>

= References =
* [http://blog.kovyrin.net/2006/04/29/monitoring-nginx-with-rrdtool/ Monitoring Nginx with RRDtool]
* [http://dev.2xlp.com/svn/nginx_config/trunk/conf/_rrd/__README__.txt RRDtool README]
* [http://exchange.munin-monitoring.org Munin Plugin Exchange] (containing plugins for Nginx)
* [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.

← Older revision		Revision as of 21:55, 14 April 2013
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]

@@ Line 37: / Line 37: @@
 </pre>
-<code>active connections</code> -- number of all open connections including connections to backends
+<code>active connections</code> -- number of all open connections <s>including connections to backends</s>
 <code>server accepts handled requests</code> -- nginx accepted 16630948 connections, handled 16630948 connections (no one was closed just it was accepted), and handles 31070465 requests