Plugins 〉Traffic Light


Developer

Jack Westbrook


Sign up to receive occasional product news and updates:



Panel
community

Traffic Light

  • Overview
  • Installation
  • Change log
  • Related content

Heywesty Traffic light panel

CI  Latest Version Badge

A traffic light to help you interpret complex information at a glance.

Requirements

Grafana >=9.5.3

Features

  • Customizable Traffic Light Width: Set the minimum width for each traffic light.
  • Grid/Single Row Layout: Ability to layout lights on a grid or in a single row.
  • Reversible light colors: Reverse the order of traffic light colors.
  • Sorting Options: Sort the traffic lights based on values in ascending, descending, or series (none) order.
  • Value Display: Option to show or hide the values associated with each light.
  • Legend Display: Option to show or hide the legend (query name) associated with each light.
  • Trend Display: Show or hide the trend color to provide an additional layer of information.
  • Traffic Light Style: Pick a style of traffic light. If you want a custom number of lights use dynamic.
  • Orientation Flexibility: Choose between a vertical or horizontal layout for the traffic lights.

Installation

This plugin can be installed using one of the following methods:

Usage

The traffic light panel uses the built in Grafana thresholds to assign lights to values.

  1. Choose a traffic light style: In the panel settings, select a light style. Dynamic allows you to add any number of lights based on the threshold settings. All other light styles require 3 thresholds to be set.

  2. Define Thresholds: In the panel settings, define thresholds that categorize your data. A basic thresholds example for a traffic light looks like:

  3. Assign Colors: Assign colors to each threshold range. These colors will be used to represent the corresponding data values in the traffic lights.

  4. Preview and Adjust: After setting the thresholds, preview them on your dashboard. Adjust the thresholds and colors as necessary to accurately reflect the status indicated by your data.

  5. Data Links: Optionally add datalinks to make the traffic light panel navigate elsewhere on click.

[!TIP] Make use of threshold overrides if you'd like to set traffic lights with different colour schemes. If you're using dynamic lights you can also set different numbers of lights.

Options

Getting started is as simple as adding the panel to your dashboard and tweaking a few settings:

  1. Minimum Light Width: Decide how big your traffic lights should be for clear visibility. The default setting is 100 pixels.
  2. Single Row View: By default each light will flow in an auto grid layout. This can be controlled by adjusting the minimum light width. Enable this if you'd prefer to keep all lights on one row.
  3. Reverse Light Color: Due to Grafana auto sorting thresholds, this option caters for situations where the "base" threshold should be considered "go" and the highest threshold should be considered "stop".
  4. Show Value: Choose whether to display the numerical values with each light. True by default.
  5. Show Legend: Choose whether to display the numerical values with each light. True by default.
  6. Show Trend: Add an extra layer of insight with a trend color. True by default.
  7. Traffic Light Style: Choose from one of: default, rounded, side lights, or dynamic.
  8. Sort Lights: Organize your traffic lights in the order that makes sense to you:
    • None: Keep data series order.
    • Ascending: Line them up from lowest to highest values.
    • Descending: Line them up from highest to lowest values.
  9. Orientation: Set the lights horizontally or stick to the default vertical layout.

Troubleshooting / Help

The query returned no data.

Check the datasource is returning data from the query.

This data format is unsupported.

The plugin supports any data source that returns data frame(s) containing one numeric field.

Thresholds are incorrectly set.

Thresholds need to be set for the plugin to operate. Please see usage section above. Thresholds must contain base and two other values. One for each light.

Installing Traffic Light on Grafana Cloud:

For more information, visit the docs on plugin installation.

Changelog

0.5.0

  • Feat: Dynamic Lights style allowing any number of lights to be used
  • Fix: Sort should sort numerically
  • Chore: Bump @grafana/create-plugin configuration to 5.5.3
  • CI: Update all GH workflows to latest create-plugin

0.4.1

  • Chore: Bump @grafana/create-plugin configuration to 5.3.9

0.4.0

  • Feature: Support table data
  • Chore: fix license file
  • Chore: Bump @grafana/create-plugin configuration to 4.16.2
  • Deps: bump ws from 8.13.0 to 8.17.1

0.3.1

  • Bug: Fix queries with a single field
  • Chore: Bump @grafana/create-plugin configuration to 4.12.0
  • CI: introduce cp update workflow

0.3.0

  • Add new option to reverse the order of colors in traffic lights
  • Add new option to show only the legend (query name) below traffic lights
  • Clean up e2e tests with test ids const and bumping plugin-e2e to 1.x.x
  • Introduce e2e tests for TrafficLightValue component

0.2.0

  • Add a new option to select different traffic light styles (default, rounded, side-lights)
  • Add some basic tests for utils
  • Add plugin-e2e package with playwright for e2e tests
  • Fix bugs with calculateRowsAndColumns where itemcount and containerWidth weren't being considered causing potential layout breakages
  • Fix a bug with calculateRowsAndColumns using data.series.length causing broken layouts due to returning a different length to useDatas values which we should consider the source of truth.

0.1.0

Initial release.