NGINX Status Monitoring Configuration225

NGINX is a popular web server and reverse proxy that provides various metrics and information about its performance and status. Monitoring these metrics is crucial for ensuring the smooth operation of your web applications and infrastructure.

NGINX's built-in status module provides a convenient way to access these metrics through a dedicated URL. This module allows you to track information such as active connections, request counts, and resource usage.

Configuring NGINX Status Monitoring

To enable NGINX status monitoring, you need to configure the following directive in your NGINX configuration file:```nginx
location /nginx-status {
stub_status on;
access_log off;
allow ...;
deny all;
}
```

stub_status on; Enables the status module.
access_log off; Disables access logging for the status page.
allow \ \ ...; Restricts access to the status page to the specified IP addresses. Replace \ with the IP addresses that should be allowed to access the status page.
deny all; Denies access to all other IP addresses.

Example Configuration

Here's an example configuration that enables status monitoring on port 8080 and restricts access to the IP addresses 192.168.1.10 and 192.168.1.20:```nginx
server {
listen 80;
server_name ;
# ... other server configuration
location /nginx-status {
stub_status on;
access_log off;
allow 192.168.1.10 192.168.1.20;
deny all;
}
}
```

Accessing the Status Page

Once you have configured NGINX status monitoring, you can access the status page by navigating to the following URL:```
:/nginx-status
```

\ is the IP address or hostname of the server running NGINX.
\ is the port number you specified in the location block (default: 8080).

Metrics Available in the Status Page

The status page provides various metrics organized into the following sections:

Active Connections

accepts: Total number of accepted connections.
handled: Total number of handled connections.
requests: Total number of requests.
reading: Number of connections that are currently reading data from the client.
writing: Number of connections that are currently writing data to the client.
waiting: Number of connections that are waiting for an event.

Requests

total: Total number of requests.
current: Number of current connections.
1xx, 2xx, 3xx, 4xx, 5xx: Number of requests with the corresponding HTTP status code.

Server Zones

If you have configured server zones in NGINX, this section provides information about each zone, including metrics such as the number of active connections, accepted connections, handled connections, and requests.

Upstream Zones

If you have configured upstream zones in NGINX, this section provides information about each zone, including metrics such as the number of active connections, accepted connections, handled connections, and requests.

Cache Statistics

This section provides information about the NGINX cache, including metrics such as the number of cache hits, cache misses, and cache size.

SSL Statistics

If you have configured SSL in NGINX, this section provides information about SSL connections, including metrics such as the number of active SSL connections, SSL handshakes, and SSL renegotiations.

Additional Statistics

This section provides various other statistics, including:
pid: NGINX process ID.
uptime: NGINX uptime.
traffic: Total traffic volume.
connections: Total number of connections.
SSL connections: Total number of SSL connections.

Monitoring NGINX Status with Prometheus

You can also monitor NGINX status metrics using a Prometheus exporter. NGINX provides an official exporter module that collects metrics from the status page and exports them in Prometheus format.

To use the Prometheus exporter:1. Install the NGINX Prometheus exporter module.
2. Configure the exporter in your NGINX configuration file.
3. Run the Prometheus exporter.
4. Configure Prometheus to scrape metrics from the exporter.

Conclusion

NGINX status monitoring allows you to monitor the performance and health of your NGINX server. The built-in status module provides a convenient way to access various metrics and detect potential issues early on.

By regularly monitoring NGINX status metrics, you can ensure the stability, reliability, and performance of your web applications and infrastructure.

2024-12-31

---

Previous：Maximize Uptime and Efficiency: A Guide to Target Monitoring Setup

Next：Outdoor Box Camera Installation Guide