Legacy plugins

    You can extend Grafana by writing your own plugins and then share them with other users in our plugin repository.

    Grafana already has a strong community of contributors and plugin developers. By making it easier to develop and install plugins with resources such as this guide, we hope that the community can grow even stronger and develop new plugins that we would never think about.

    1. Set up Grafana
    2. Clone an example plugin into or data/plugins (relative to grafana git repo if you’re running development version from source dir)
    3. Use one of our example plugins as a starting point

    Example plugins

    You might also be interested in the available tutorials around authoring a plugin.

    What languages?

    Since everything turns into JavaScript, it’s up to you to choose which language you want. That said, it’s probably a good idea to choose es6 or TypeScript, because we use es6 classes in Grafana. So it’s easier to get inspiration from the Grafana repo if you choose one of those languages.

    Buildscript

    New versions of Grafana can sometimes cause plugins to break. Check out our doc for changes in Grafana that can impact your plugin.

    Metadata

    See the for details on the metadata.

    module.(js|ts)

    This is the entry point for every plugin. This is the place where you should export your plugin implementation. Depending on what kind of plugin you are developing you will be expected to export different things. You can find what’s expected for , panels and plugins in the documentation.

    The Grafana SDK is quite small so far and can be found here:

    The SDK contains three different plugin classes: PanelCtrl, MetricsPanelCtrl and QueryCtrl. For plugins of the panel type, the module.js file should export one of these. There are some extra classes for .

    The module class is also where css for the dark and light themes is imported:

    1. import { loadPluginCss } from 'app/plugins/sdk';
    2. import WorldmapCtrl from './worldmap_ctrl';
    5.   dark: 'plugins/grafana-worldmap-panel/css/worldmap.dark.css',
    6.   light: 'plugins/grafana-worldmap-panel/css/worldmap.light.css',
    7. });
    9. export { WorldmapCtrl as PanelCtrl };

    There are three ways that you can start developing a Grafana plugin.

    1. Set up a Grafana development environment. and place your plugin in the folder.
    2. Install Grafana and place your plugin in the plugins directory which is set in your config file. By default this is /var/lib/grafana/plugins on Linux systems.

    We encourage people to set up the full Grafana environment so that you can get inspiration from the rest of the Grafana code base.

    When Grafana starts, it scans the plugin folders and mounts every folder that contains a plugin.json file unless the folder contains a subfolder named dist. In that case, Grafana mounts the dist folder instead. This makes it possible to have both built and src content in the same plugin Git repo.

    Grafana Events

    There are a number of Grafana events that a plugin can hook into:

    • init-edit-mode can be used to add tabs when editing a panel
    • panel-teardown can be used for clean up
    • data-received is an event in that is triggered on data refresh and can be hooked into
    • data-snapshot-load is an event triggered to load data when in snapshot mode.
    • is used to handle errors on dashboard refresh.

    Examples

    We have three different examples that you can fork/download to get started developing your Grafana plugin.