FAQ

Page Discussion History

Difference between revisions of "HttpStubStatusModule"

(stub_status)
m (removed top padding)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<!-- page was renamed from NginxStubStatusModule
+
__NOINDEX__
-->
+
 
 +
<span style="color:red">WARNING: this article is obsoleted. Please refer to http://nginx.org/en/docs/ for the latest official documentation.</span>
 +
 
 
= Synopsis =
 
= Synopsis =
 
This module provides the ability to get some status from nginx.
 
This module provides the ability to get some status from nginx.
Line 54: Line 56:
 
* [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 10:45, 25 August 2014


WARNING: this article is obsoleted. Please refer to http://nginx.org/en/docs/ for the latest official documentation.

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