grafana/docs/sources/developers/plugins/create-a-grafana-plugin/extend-a-plugin/add-support-for-annotations.md

1.2 KiB

title menuTitle aliases description keywords weight
Enable annotations Enable annotations
../../../plugins/add-support-for-annotations/
Add support for annotations in your plugin.
grafana
plugins
plugin
annotations
100

Enable annotations

You can add support to your plugin for annotations that will insert information into Grafana alerts. This guide explains how to add support for [annotations]({{< relref "../../../../dashboards/build-dashboards/annotate-visualizations#querying-other-data-sources" >}}) to a data source plugin.

Support annotations in your data source plugin

To enable annotations, simply add two lines of code to your plugin. Grafana uses your default query editor for editing annotation queries.

  1. Add "annotations": true to the [plugin.json]({{< relref "../../metadata.md" >}}) file to let Grafana know that your plugin supports annotations.

    In plugin.json:

    {
      "annotations": true
    }
    
  2. In datasource.ts, override the annotations property from DataSourceApi (or DataSourceWithBackend for backend data sources). For the default behavior, set annotations to an empty object.

    In datasource.ts:

    annotations: {
    }