Annotations list
Grafana Cloud Enterprise Open source

Annotations list

The annotations list shows a list of available annotations you can use to view annotated data. Various options are available to filter the list based on tags and on the current dashboard.

The annotations list visualization

Configuration options

The following section describes the configuration options available in the panel editor pane for this visualization. These options are, as much as possible, ordered as they appear in Grafana.

Panel options

In the Panel options section of the panel editor pane, set basic options like panel title and description, as well as panel links. To learn more, refer to Configure panel options.

Annotation query options

The following options control the source query for the list of annotations:

OptionDescription
Query filterSpecify which annotations are included in the list.
Time RangeSpecify whether the list should be limited to the current time range.
TagsFilter the annotations by tags. You can add multiple tags to refine the list. Optionally, leave the tag list empty and filter in view mode by selecting tags that are listed as part of the results on the panel itself.
LimitLimit the number of results returned.

Query filter

Use the Query filter option to create a list of annotations from all dashboards in your organization or the current dashboard in which this panel is located. Choose from:

  • All dashboards - List annotations from all dashboards in the current organization.
  • This dashboard - Limit the list to the annotations on the current dashboard.

Time Range

Specify whether the list should be limited to the current time range. Choose from:

  • None - No time range limit for the annotations query.
  • This dashboard - Limit the list to the time range of the dashboard where the annotations list is available.

Display options

These options control additional metadata included in the annotations list display:

OptionDescription
Show userShow or hide which user created the annotation.
Show timeShow or hide the time the annotation creation time.
Show tagsShow or hide the tags associated with an annotation. Note that you can use the tags to filter the annotations list.

Use the following options to control the behavior of annotation links in the list:

OptionDescription
Link targetSet how to view the annotated data. Choose from:
  • Panel - The link takes you directly to a full-screen view of the panel with the corresponding annotation.
  • Dashboard - Focuses the annotation in the context of a complete dashboard.
Time beforeSet the time range before the annotation. Use duration string values like 1h for one hour and 10m for 10 minutes.
Time afterSet the time range after the annotation.