Documentationbreadcrumb arrow Pluginsbreadcrumb arrow Jira data sourcebreadcrumb arrow Annotations

Create annotations from Jira data

Annotations allow you to overlay Jira issue events on time series visualizations. Use annotations to correlate issue creation, resolution, or status changes with metrics from other data sources.

For general information about annotations in Grafana, refer to Annotate visualizations.

Add a Jira annotation query

To create annotations from Jira data:

  1. Open your dashboard and click Dashboard settings (gear icon).
  2. Select Annotations in the left menu.
  3. Click Add annotation query.
  4. Enter a name for the annotation.
  5. Select your Jira data source from the Data source drop-down.
  6. Configure the annotation query:
    • Select a date field as the time field (for example, Created, Updated, or Resolution Date)
    • Select a text field for the annotation label (for example, Summary or Key)
    • Add a JQL filter to limit which issues appear as annotations
  7. Click Apply.

Common annotation use cases

The following examples demonstrate common annotation use cases.

Show when issues are created

Overlay markers on your visualizations when new issues are created:

  • Time field: Created
  • Text field: Summary
  • JQL Filter: project = 'Your Project' AND created >= -7d

Show when issues are resolved

Track issue resolutions alongside your metrics:

  • Time field: Resolution Date
  • Text field: Summary
  • JQL Filter: project = 'Your Project' AND resolved >= -30d

Highlight issues related to deployments or releases:

  • Time field: Updated
  • Text field: Key
  • JQL Filter: project = 'Your Project' AND labels = 'deployment'

Show high-priority issues

Mark when critical issues are created or updated:

  • Time field: Created
  • Text field: Summary
  • JQL Filter: project = 'Your Project' AND priority = 'Critical' AND created >= -14d

Annotation configuration options

When configuring Jira annotations, the following options are available:

  • Name - A descriptive name for the annotation query.
  • Data source - Select your Jira data source.
  • Enabled - Toggle to show or hide annotations on the dashboard.
  • Color - Choose the annotation marker color.
  • Show in - Select which panels display the annotations.

Filter annotations by time range

Annotations are automatically filtered by the dashboard time range. To ensure relevant annotations appear:

  1. Use relative time filters in your JQL (for example, created >= -30d).
  2. Alternatively, use the time range macros $__timeFrom and $__timeTo:
jql 
created >= $__timeFrom AND created <= $__timeTo

This ensures annotations align with the dashboard’s selected time range.