NGINX is an open source web server. NGINX is used for web serving, reverse proxying, caching, load balancing, media streaming, etc.

Setup & Configuration

The NGINX plugin is included with the Atatus Infra agent by default, please follow the below section to enable.

  1. Copy the NGINX example configuration file.

    copy
    icon/buttons/copy
    cd /etc/atatus-infra-agent/conf.d/nginx.d/
    sudo cp nginx.yml.template nginx.yml
    
  2. Update the file /etc/atatus-infra-agent/conf.d/nginx.d/nginx.yml with below configurations.

    copy
    icon/buttons/copy
    # Metrics section
    metrics:
          # Nginx hosts
        - hosts: ["http://127.0.0.1"]
    
          # Path to server status. Default nginx_status
          #status_path: "nginx_status"
    
  3. Restart the atatus infrastructure agent.

    copy
    icon/buttons/copy
    sudo service atatus-infra-agent restart
    

Metrics

Name Description Type
nginx.stubstatus.accepts
The total number of accepted client connections. long
nginx.stubstatus.handled
The total number of handled client connections. long
nginx.stubstatus.dropped
The total number of dropped client connections. long
nginx.stubstatus.requests
The total number of client requests. long
nginx.stubstatus.active
The current number of active client connections including Waiting connections. long
nginx.stubstatus.reading
The current number of connections where Nginx is reading the request header. long
nginx.stubstatus.writing
The current number of connections where Nginx is writing the response back to the client. long
nginx.stubstatus.waiting
The current number of idle client connections waiting for a request. long