Skip to main content

Monitoring Nginx

Collect and monitor the general performance Metrics of Nginx.

Protocol Use:Nginx

Nginx App Enable ngx_http_stub_status_module And ngx_http_reqstat_module Configure

If you want to monitor information in 'Nginx' with this monitoring type, you need to modify your nginx configure file for enable the module monitor.

1、Add ngx_http_stub_status_module Configure:

# modify nginx.conf
server {
listen 80; # port
server_name localhost;
location /nginx-status {
stub_status on;
access_log on;
#allow; #only allow requests from localhost
#deny all; #deny all other hosts

2、Add ngx_http_reqstat_module Configure:

# install `ngx_http_reqstat_module`
wget -O


patch -p1 < ../ngx_req_status-master/write_filter.patch

./configure --prefix=/usr/local/nginx-1.4.2 --add-module=../ngx_req_status-master

make -j2

make install
# modify nginx.conf
http {
req_status_zone server_name $server_name 256k;
req_status_zone server_addr $server_addr 256k;
req_status_zone server_url $server_name$uri 256k;
req_status server_name server_addr server_url;
server {
server_name xxx; // server_name
location /req-status {
req_status_show on;

⚠️ngx_http_reqstat_module need to download it ourselves, If we don't need to monitor this module, we can only collect information about the ngx_http_stub_status_module module

There is help_doc:

Configuration parameter

Parameter nameParameter help description
Monitoring HostMonitored IPV4, IPV6 or domain name. Note⚠️Without protocol header (eg: https://, http://)
Monitoring nameIdentify the name of this monitoring. The name needs to be unique
PortPort provided by Nginx
TimeoutAllow collection response time
Collection intervalInterval time of monitor periodic data collection, unit: second, and the minimum interval that can be set is 30 seconds
Whether to detectWhether to detect and check the availability of monitoring before adding monitoring. Adding and modifying operations will continue only after the detection is successful
Description remarksFor more information about identifying and describing this monitoring, users can note information here

Collection Metrics

Metrics Set:nginx_status

Metric nameMetric unitMetric help description
acceptsAccepted connections
handledSuccessfully processed connections
activeCurrently active connections
droppedDiscarded connections
requestsClient requests
readingConnections performing read operations
writingConnections performing write operations
waitingWaiting connections

Metrics Set:req_status

Metric nameMetric unitMetric help description
zone_nameGroup category
keyGroup name
max_activeMaximum concurrent connections
max_bwkbMaximum bandwidth
traffickbTotal traffic
requestsTotal requests
activeCurrent concurrent connections
bandwidthkbCurrent bandwidth