Create Custom Dashboards

Create custom dashboards to view custom graphs


You can use the NGINX Controller user interface to create your own Dashboards populated with customizable graphs of NGINX and system-level metrics.

  • You can add up to 30 Elements to Dashboard.
  • Dashboards are accessible by all Users.

Before You Begin


In NGINX Controller, you can create dashboards to display custom graphs. Some use cases for custom graphs include the following:

  • Checking NGINX performance for a particular application or microservice, for example, based on the URI path
  • Displaying metrics per virtual server
  • Visualizing the performance of a group of NGINX servers, for example, front-end load-balancers or an NGINX edge caching layer
  • Analyzing a detailed breakdown of HTTP status codes per application

When building a custom graph, metrics can be summed or averaged across NGINX servers. By using metric filters, it is possible to create additional “metric dimensions”, for example, reporting the number of POST requests for a specific URI.

The functionality of user-defined dashboards recently changed in NGINX Controller. Some of the functionalities that were present in the previous version might not be currently present or work differently. Your old dashboards were not migrated to the new version.

Create a Custom Dashboard

To create a custom dashboard:

  1. Open the NGINX Controller user interface and log in.
  2. The first page you will see is the Analytics Overview page.
  3. Select the Dashboards tab to see the My Dashboards list page.
  4. To create a new dashboard - use Create button and provide required information.

Add a Dashboard Element

To add an Element to a Dashboard:

  1. Create a new Dashboard or select the edit icon to edit an existing Dashboard.

  2. Select Add element button.

  3. Provide a title.

  4. (Optional) Enter a description of the Element.

  5. Select the type of Element to add:

    • Line chart displays data for a specific time period
    • Stat displays the metric’s most recent value
  6. Select a metric from the drop-down menu.

  7. Select the aggregation method for the selected metric.

    See Also:
    For more information about metrics and supported aggregation methods, see the Metrics Catalog Reference.

  8. (Optional) Add a filter to refine the data. For example, you can limit the data to a specific App or Environment.

  9. (Optional) Select Add metrics to add more metrics.

    Additional metrics can only be added to a Line chart Element.

  10. (Optional) Select the Override Default Time Settings option to select a time range for the Element.

    • The default time range is the last seven days.
    • You can select a new pre-defined time range or select Custom time range to define a new time range.
  11. Select Create or Edit to save your Element settings.

Filter Metrics

You can use the filtering functionality for NGINX metrics. If you select Add filter, you can add multiple criteria to define specific “metric dimensions”.

The filter consists of one or more expressions in a form of:

dimensionName operator value


  • dimensionName is a name of the dimension from the dimensions catalog
  • operator is a comparison rule (equality, likeliness, etc.)
  • value is a value to which we want compare the dimensions value

Filters can be used in conjunction using AND or OR logical operators. There is no possibility of nesting these expressions.

Filters are used to narrow down the data set presented on the chart/stat. For example, you may not want to display the data for all of your applications, but only for the particular one.


  • You are not able to add more than 30 elements to the single dashboard.
  • All dashboards are accessible for all users.
  • Dashboards defined in the old custom dashboards view are not migrated to the new dashboards view.

What’s Next

​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​

This documentation applies to the following versions of NGINX Controller: 3.0, 3.1, 3.2, 3.3, 3.3, 3.4, 3.5, 3.6, 3.7, 3.8, 3.9, 3.10, 3.12, 3.13, 3.14, 3.15, 3.16.1, 3.17 and 3.18.