netdata/collectors/python.d.plugin/nginx_plus/README.md

3.0 KiB

NGINX Plus monitoring with Netdata

Monitors one or more NGINX Plus servers depending on configuration. Servers can be either local or remote.

Example nginx_plus configuration can be found in 'python.d/nginx_plus.conf'

It produces following charts:

  1. Requests total in requests/s

    • total
  2. Requests current in requests

    • current
  3. Connection Statistics in connections/s

    • accepted
    • dropped
  4. Workers Statistics in workers

    • idle
    • active
  5. SSL Handshakes in handshakes/s

    • successful
    • failed
  6. SSL Session Reuses in sessions/s

    • reused
  7. SSL Memory Usage in percent

    • usage
  8. Processes in processes

    • respawned

For every server zone:

  1. Processing in requests
  • processing
  1. Requests in requests/s

    • requests
  2. Responses in requests/s

    • 1xx
    • 2xx
    • 3xx
    • 4xx
    • 5xx
  3. Traffic in kilobits/s

    • received
    • sent

For every upstream:

  1. Peers Requests in requests/s

    • peer name (dimension per peer)
  2. All Peers Responses in responses/s

    • 1xx
    • 2xx
    • 3xx
    • 4xx
    • 5xx
  3. Peer Responses in requests/s (for every peer)

    • 1xx
    • 2xx
    • 3xx
    • 4xx
    • 5xx
  4. Peers Connections in active

    • peer name (dimension per peer)
  5. Peers Connections Usage in percent

    • peer name (dimension per peer)
  6. All Peers Traffic in KB

    • received
    • sent
  7. Peer Traffic in KB/s (for every peer)

    • received
    • sent
  8. Peer Timings in ms (for every peer)

    • header
    • response
  9. Memory Usage in percent

    • usage
  10. Peers Status in state

    • peer name (dimension per peer)
  11. Peers Total Downtime in seconds

    • peer name (dimension per peer)

For every cache:

  1. Traffic in KB

    • served
    • written
    • bypass
  2. Memory Usage in percent

    • usage

Configuration

Edit the python.d/nginx_plus.conf configuration file using edit-config from the your agent's config directory, which is typically at /etc/netdata.

cd /etc/netdata   # Replace this path with your Netdata config directory, if different
sudo ./edit-config python.d/nginx_plus.conf

Needs only url to server's status.

Here is an example for a local server:

local:
  url     : 'http://localhost/status'

Without configuration, module fail to start.


analytics