Prometheus

Enabling Metrics

If you’re using Kubernetes manifests (Deployment or DaemonSet) to install the Ingress Controller, to enable Prometheus metrics:

1. Run the Ingress controller with the -enable-prometheus-metrics command-line argument. As a result, the Ingress Controller will expose NGINX or NGINX Plus metrics in the Prometheus format via the path /metrics on port 9113 (customizable via the -prometheus-metrics-listen-port command-line argument).

2. Add the Prometheus port to the list of the ports of the Ingress Controller container in the template of the Ingress Controller pod:

   - name: prometheus
     containerPort: 9113
   

3. Make Prometheus aware of the Ingress Controller targets by adding the following annotations to the template of the Ingress Controller pod (note: this assumes your Prometheus is configured to discover targets by analyzing the annotations of pods):

   annotations:
       prometheus.io/scrape: "true"
       prometheus.io/port: "9113"
   

If you’re using Helm to install the Ingress Controller, to enable Prometheus metrics, configure the prometheus.* parameters of the Helm chart. See the Installation with Helm doc.

Available Metrics

The Ingress Controller exports the following metrics:

• NGINX/NGINX Plus metrics. Please see this doc to find more information about the exported metrics.
• Ingress Controller metrics
  • controller_nginx_reloads_total. Number of successful NGINX reloads.
  • controller_nginx_reload_errors_total. Number of unsuccessful NGINX reloads.
  • controller_nginx_last_reload_status. Status of the last NGINX reload, 0 meaning down and 1 up.
  • controller_nginx_last_reload_milliseconds. Duration in milliseconds of the last NGINX reload.
  • controller_ingress_resources_total. Number of handled Ingress resources. This metric includes the label type, that groups the Ingress resources by their type (regular, minion or master). Note: The metric doesn’t count minions without a master.
  • controller_virtualserver_resources_total. Number of handled VirtualServer resources.
  • controller_virtualserverroute_resources_total. Number of handled VirtualServerRoute resources. Note: The metric counts only VirtualServerRoutes that have a reference from a VirtualServer.

Note: all metrics have the namespace nginx_ingress. For example, nginx_ingress_controller_nginx_reloads_total.