Skip to main content
Version: 3.7.0

Nginx

Collect Nginx service Metrics and send them to ONE to detect and analyze anomalies in your load-balancers or web servers.

Prerequisites​

  • A working SmartGate Agent is already deployed in the environment.
  • Network connectivity exists between the Nginx hosts and the ONE platform.

Getting Started​

ONE Platform Setup​

  • Navigate to Integrations → Plugins.Locate the Nginx card and click Start Integration.
  • Add an Nginx component, choose the SmartGate that will scrape it, and fill in the connection settings displayed on the page.
    Reference exporter: https://github.com/nginx/nginx-prometheus-exporter
  • Save the job; it is created in the disabled state.
  • Manually enable the job to begin processing.

Source Side Setup​

  • Ensure Nginx is compiled with ngx_http_stub_status_module (or use ngx_http_api_module for Plus).
  • Create status.conf (e.g. /usr/local/nginx/conf/status.conf):
 listen 81;
 server_name localhost;

 access_log off;
 \# allow 127.0.0.1;
 \# deny all;

 location /nginx_status {
  \# Choose your status module

  \# freely available with open source NGINX
  stub_status;

  \# for open source NGINX < version 1.7.5
  \# stub_status on;

  \# available only with NGINX Plus
  \# status;
 }
}
  • Translate: Configure the nginx.conf file and add the following configuration block in the http section.
http {
 include /usr/local/nginx/conf/status.conf
}

Configure Data Stream​

  • ONE provides an out-of-the-box default stream.
  • You can also build a custom stream for advanced monitoring scenarios.

Verification​

  • Review registered Metrics under Insight → Data Model → Metrics.