Nginx

Version 1

    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