Nginx Plus monitoring - Commands & Configuration

Introduction

Nginx Plus monitoring helps you see how your web server is performing and if it is handling traffic well. It shows you live data about connections, requests, and server health so you can fix problems quickly.

When you want to check how many users are connected to your web server right now.

When you need to see if your backend servers are healthy and responding.

When you want to track how many requests your server handles per second.

When you want to find out if your server is overloaded or running smoothly.

When you want to get detailed stats to improve your server setup.

Config File - nginx.conf

nginx.conf

worker_processes  1;

events {
    worker_connections  1024;
}

http {
    # Enable the status zone for Nginx Plus monitoring
    status_zone nginx_status;

    server {
        listen 8080;

        location /status {
            # Enable the Nginx Plus status module
            status;
        }
    }
}

This configuration enables the Nginx Plus status module on port 8080 under the /status path.

The status_zone directive creates a shared memory zone to store status data.

The location /status block activates the status endpoint that provides live monitoring data.

Commands

Check the Nginx configuration file for syntax errors before applying changes.

Terminal

sudo nginx -t

Expected Output

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok

nginx: configuration file /etc/nginx/nginx.conf test is successful

Reload Nginx to apply the new configuration without stopping the server.

Terminal

sudo systemctl reload nginx

Expected Output

No output (command runs silently)

Fetch the live status data from the Nginx Plus monitoring endpoint to see current server metrics.

Terminal

curl http://localhost:8080/status

Expected Output

{

  "connections": {

    "active": 10,

    "idle": 5,

    "reading": 1,

    "writing": 2,

    "waiting": 2

  },

  "requests": {

    "total": 12345,

    "current": 3,

    "per_second": 15

  },

  "upstreams": {

    "backend": {

      "servers": [

        {

          "server": "192.168.1.10:80",

          "state": "up",

          "requests": 6000

        },

        {

          "server": "192.168.1.11:80",

          "state": "up",

          "requests": 6345

        }

      ]

    }

  }

}

Key Concept

If you remember nothing else from this pattern, remember: Nginx Plus monitoring gives you real-time data about your server’s health and traffic through a special status endpoint.

Common Mistakes

Not enabling the status module in the configuration.

Without enabling the status module, the /status endpoint will not provide monitoring data.

Add the 'status;' directive inside the location block and define a status_zone in the http block.

Forgetting to reload Nginx after changing the configuration.

Nginx will continue running with the old configuration until reloaded or restarted.

Run 'sudo systemctl reload nginx' to apply configuration changes without downtime.

Trying to access the status endpoint on the wrong port or path.

The status endpoint is only available on the configured port and path, so accessing elsewhere returns errors.

Use the exact URL configured, for example, 'http://localhost:8080/status'.

Summary

Configure Nginx Plus to enable the status module on a specific port and path.

Test the configuration syntax and reload Nginx to apply changes safely.

Use curl to fetch live monitoring data from the status endpoint to check server health.