WHERE DO I START?
You are here:Integrations > Nginx

Nginx

Summary

Nginx is an adaptable web server that can act as a reverse proxy server, load balancer, or HTTP cache. Netuitive can be used to monitor the performance of your Nginx server.

Configuration

Important   If you haven't installed the Linux agent already, see the instructions on this page for how to install it. If you need to disable the Linux integration or view the unique API key assigned to your account, navigate to the Integrations page under the user account drop-down menu and click the integration designated as Infrastructure under the Integration column.

Collector Configuration

  1. Navigate to the collectors folder.
    Note   The default location is /opt/netuitive-agent/conf/collectors.
  2. Open the NginxCollector.conf file.
    Note   This configuration file will only be available in agent versions 0.3.1 or later. Otherwise, you will have to create a configuration file with the same name.
  3. Change the enabled setting to True.
  4. Save the file.
  5. Navigate to your Nginx server configuration file.
  6. Add an additional section to your file:
    server {
      listen 127.0.0.1;
      server_name localhost;
      location /nginx_status {
        # turns on nginx stats #
        stub_status on;
        # turns off logging #
        access_log off;
        allow 127.0.0.1;
        # sends rest of world to /dev/null #
        deny all;
      }
    }
  7. Save the Nginx configuration file, and restart the Linux Agent.
  8. Note   This integration's package (computed metrics, dashboards, and policies that will give you important events and alerts) will be automatically enabled and provisioned to your account as soon as Netuitive receives data from the integration. The PACKAGES button on the integration setup page will become active once data is received, so you'll be able to disable and re-enable the package at will.

Additional Configuration Options

Dependencies

OS

Redhat 6 and 7
CentOS 6 and 7
Amazon Linux (latest)
Ubuntu 12, 14, 15, and 16
Debian 7, 8, and 9

Miscellaneous

Linux Agent
urllib2
Nginx

Metrics

Collected

Fully Qualified Name (FQN) Description Statistic Units Min Max Sparse Data Strategy (SDS) BASE CORR UTIL
nginx.act_reads The average number of active connections that were reading during the prior interval. average count 0 none none
nginx.act_waits The average number of active connections that were waiting during the prior interval. average count 0 none none
nginx.act_writes The average number of active connections that were writing during the prior interval. average count 0 none none
nginx.active_connections The average number of active connections during the prior interval. average count 0 none none
nginx.conn_accepted The total number of connections accepted during the prior interval. sum count 0 none none
nginx.conn_handled The total number of connections handled during the prior interval. sum count 0 none none
nginx.req_handled The total number of requests handled during the prior interval. sum count 0 none none

Computed

Fully Qualifed Name (FQN) Description Units Min Max BASE CORR UTIL Related Default policies
netuitive.nginx.requests_per_connection

The average number of requests handled by each connection during the prior interval.

Computation:
data['nginx.conn_handled'].actual == 0 ? 0 : data['nginx.req_handled'].actual / data['nginx.conn_handled'].actual

count 0 none  
netuitive.nginx.requests_per_second

The average number of requests per second.

Computation:
data['nginx.req_handled'].actual / 300

ops 0 none