This template retrieves the replication status of a Nginx server installed on a Linux or Unix computer.
Prerequisites: SSH and Perl installed on the target server. SNMP installed on the target server and permission to monitor the nginx process.
Credentials: Root credentials on the target server.
This template was tested on Nginx 1.6.2.
Monitored Components
Nginx Server Status
The returned values are as follows:
Active – This component returns the number of all open connections. This does not mean the number of users. A single user for a single page view can open many concurrent connections to the server.
Accepted – This component returns the total number of accepted connections. Usually it is the same number as the Handled statistic.
Handled – This component returns the total handled connections. Usually it is the same number as the Accepted statistic.
Requests – This component returns the number of handles requests. This is usually greater than Handled value.
Requests per Connection – This component returns the number of requests per connection handled by Nginx.
Reading – This component returns the number of currently reading requests header.
Writing – This component returns the number of currently reading requests body, processing requests, or writing responses to a client.
Waiting – This component returns the number of keep-alive connections, calculated as: Active-(Reading+Writing). Non-zero values do not always mean poor performance because this value depends on the keepalive-timeout setting.
Note: Before using this monitor, the correct argument should be set. This monitor requires the following arguments:
perl ${SCRIPT} ip_address port
where
ip_address – is the IP address of the target server. The localhost or loopback address could be used here. The default value is 127.0.0.1.
port - This is the port number under which Nginx operate. The default value is 80.
Below is an example using the Scripts Arguments field:
perl ${SCRIPT} 127.0.0.1 80
Process: Nginx
This monitor returns CPU and memory usage of Nginx.
TCP Port: Nginx
This component monitor tests the ability of Nginx to accept incoming sessions. It monitors TCP port 80.
Copyright 2014. Portions of this template is based on the following articles: https://rtcamp.com/tutorials/nginx/status-page/.
Last updated 11/18/2014