Plugins 〉Percentage Trend


Developer

Niko Schmuck

Sign up to receive occasional product news and updates:


Grafana Cloud
Grafana Cloud
  • Grafana, of course
  • 10k series Prometheus metrics
  • 50 GB logs
  • 50 GB traces
  • 2,232 app o11y host hours
  • ...and more
Create free account

No credit card needed, ever.


Panel
community

Percentage Trend

  • Overview
  • Installation
  • Change log
  • Related content

Grafana Percent Trend Stat Panel

Build

A panel plugin for Grafana >= 8.1.0 which computes and displays percent with trend compared to a previous value in a stat style big value manner.

Sample panel

Configuration allows to display the percentage value compared to the base value plain or interpret the percentage change as difference ("trend") with a colored (green/red) triangle symbol to see the trend evolution easily.

The idea for this plugin panel was inspired by an article about Embedded Analytics.

This plugin is reviewed by Grafana engineers and released on GrafanaLabs, see Plugins -> Panel (Community): Percentage Trend

Install

Download the latest release (named nikosc-percenttrend-panel-<version>.zip) and unzip it in your grafana plugin folder.

Usage

  1. Query two metrics, remember field names, which have to be specified in the next step

  2. Select the field names of the query results and use them to display your percentage trend

    Configure details in panel options

More resources

Installing Percentage Trend on Grafana Cloud:

For more information, visit the docs on plugin installation.

Installing on a local Grafana:

For local instances, plugins are installed and updated via a simple CLI command. Plugins are not updated automatically, however you will be notified when updates are available right within your Grafana.

1. Install the Panel

Use the grafana-cli tool to install Percentage Trend from the commandline:

grafana-cli plugins install 

The plugin will be installed into your grafana plugins directory; the default is /var/lib/grafana/plugins. More information on the cli tool.

2. Add the Panel to a Dashboard

Installed panels are available immediately in the Dashboards section in your Grafana main menu, and can be added like any other core panel in Grafana.

To see a list of installed panels, click the Plugins item in the main menu. Both core panels and installed panels will appear.

Changelog

1.0.8 (2024-01-23)

  • Show percentage value if base value (ie. from previous time range) is not available.

1.0.7 (2022-11-06)

  • Fixed prefix in case of negative percentage trend

1.0.6 (2022-10-25)

  • Support locale unit for percentage value (thanks @itsnull12)
  • Allow to specify number of decimals displayed for percentage value
  • Improved display in case no previous ("base") value available instead of infinity
  • Improved display of stagnation (= 0% difference to base value)

1.0.5 (2022-10-19)

  • Allow to invert colorization of trend (thanks @jammiemil)

1.0.4 (2022-10-07)

  • Turned screenshot images from README from relative to absolute URLs
  • Submission to Grafana Community

1.0.3 (2022-10-05)

  • Checked backward compatibility, set from 7.0.0 to 8.1.0
  • Improved check for existence of referred data frames (kudos to Esteban)

1.0.2 (2022-10-04)

  • Avoid usage of deprecated UI theme and style setup
  • Fixed bug when using pixel to specify percentage value size

1.0.1 (2022-09-30)

  • Added logo

1.0.0 (2022-09-29)

  • Initial release