This is documentation for the next version of Grafana. For the latest stable release, go to the latest version.

DevelopersBuild a pluginAdd support for annotations

Add support for annotations

This guide explains how to add support for annotations to an existing data source plugin.

This guide assumes that you’re already familiar with how to Build a data source plugin.

Note: Annotation support for React plugins was released in Grafana 7.2. To support earlier versions, refer to the Add support for annotation for Grafana 7.1.

Add annotations support to your data source

To enable annotation support for your data source, add the following two lines of code. Grafana uses your default query editor for editing annotation queries.

  1. Add "annotations": true to the plugin.json file to let Grafana know that your plugin supports annotations.

    plugin.json

    {
      "annotations": true
    }
    
  2. In datasource.ts, override the annotations property from DataSourceApi. For the default behavior, you can set annotations to an empty object.

    datasource.ts

    annotations: {};