Menu

Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Enterprise Open source

Thresholds

Thresholds set the color of either the value text or the background depending on conditions that you define.

You can define thresholds one of two ways:

  • Absolute thresholds are defined based on a number. For example, 80 on a scale of 1 to 150.
  • Percentage thresholds are defined relative to minimum or maximum. For example, 80 percent.

You can apply thresholds to the following visualizations:

Default thresholds

On visualizations that support it, Grafana sets default threshold values of:

  • 80 = red
  • Base = green
  • Mode = Absolute

The Base value represents minus infinity. It is generally the “good” color.

Add a threshold

You can add as many thresholds to a panel as you want. Grafana automatically sorts thresholds from highest value to lowest.

Note: These instructions apply only to the Stat, Gauge, Bar gauge, and Table visualizations.

  1. Navigate to the panel you want to add a threshold to.
  2. Click the Field tab.
  3. Click Add threshold.
  4. Grafana adds a threshold with suggested numerical and color values.
  5. Accept the recommendations or edit the new threshold.
    • Edit color: Click the color dot you wish to change and then select a new color.
    • Edit number: Click the number you wish to change and then enter a new number.
    • Thresholds mode - Click the mode to change it for all thresholds on this panel.
  6. Click Save to save the changes in the dashboard.

Add a threshold to a Graph panel

In the Graph panel visualization, thresholds allow you to add arbitrary lines or sections to the graph to make it easier to see when the graph crosses a particular threshold.

  1. Navigate to the graph panel you want to add a threshold to.
  2. On the Panel tab, click Thresholds.
  3. Click Add threshold.
  4. Fill in as many fields as you want. Only the T1 fields are required.
    • T1 - Both values are required to display a threshold.
      • lt or gt - Select lt for less than or gt for greater than to indicate what the threshold applies to.
      • Value - Enter a threshold value. Grafana draws a threshold line along the Y-axis at that value.
    • Color - Choose a condition that corresponds to a color, or define your own color.
      • custom - You define the fill color and line color.
      • critical - Fill and line color are red.
      • warning - Fill and line color are yellow.
      • ok - Fill and line color are green.
    • Fill - Controls whether the threshold fill is displayed.
    • Line - Controls whether the threshold line is displayed.
    • Y-Axis - Choose left or right.
  5. Click Save to save the changes in the dashboard.

Delete a threshold

  1. Navigate to the panel you want to add a threshold to.
  2. Click the Field tab. (Or Panel tab for a graph panel.)
  3. Click the trash can icon next to the threshold you want to remove.
  4. Click Save to save the changes in the dashboard.