NGINX Documentation

Status Page

NGINX comes with a status page that reports basic metrics about NGINX called the stub status. NGINX Plus comes with a dashboard that reports key load-balancing and performance metrics. This doc shows how to get access to the stub status/dashboard.

Accessing Stub Status

Prerequisites:

  1. The stub status is enabled by default. Ensure that the nginx-status command-line argument is not set to false.
  2. The stub status is available on port 8080 by default. It is customizable by the nginx-status-port command-line argument. If yours is not on 8080, modify the kubectl proxy command below.

To access the status:

  1. Use the kubectl port-forward command to forward connections to port 8080 on your local machine to port 8080 of an NGINX Ingress controller pod (replace <nginx-ingress-pod> with the actual name of a pod):.

    $ kubectl port-forward <nginx-ingress-pod> 8080:8080 --namespace=nginx-ingress
    
  2. Open your browser at http://127.0.0.1:8080/stub_status to access the status.

If you want to access the stub status externally (without kubectl port-forward):

  1. Configure -nginx-status-allow-cidrs command-line argument with IPv4 IP/CIDR blocks for which you want to allow access to the status. By default, the access is allowed for 127.0.0.1.
  2. Use the IP/port through which the Ingress Controller pod/pods are available to connect the stub status at the /stub_status path.

Accessing Live Activity Monitoring Dashboard

Prerequisites:

  1. The dashboard is enabled by default. Ensure that the nginx-status command-line argumentis not set to false.
  2. The dashboard is available on port 8080 by default. It is customizable by the nginx-status-port command-line argument. If yours is not on 8080, modify the kubectl proxy command below.

To access the dashboard:

  1. Use the kubectl port-forward command to forward connections to port 8080 on your local machine to port 8080 of an NGINX Plus Ingress controller pod (replace <nginx-plus-ingress-pod> with the actual name of a pod):

    $ kubectl port-forward <nginx-plus-ingress-pod> 8080:8080 --namespace=nginx-ingress
    
  2. Open your browser at http://127.0.0.1:8080/dashboard.html to access the dashboard.

If you want to access the dashboard externally (without kubectl port-forward):

  1. Configure -nginx-status-allow-cidrs command-line argument with IPv4 IP/CIDR blocks for which you want to allow access to the dashboard. By default, the access is allowed for 127.0.0.1.
  2. Use the IP/port through which the Ingress Controller pod/pods are available to connect the dashboard at the /dashboard.html path.

Note: The API, which the dashboard uses to get the metrics, is also accessible: use the /api path. Note that the API is configured in the read-only mode.