Nginx

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