2022-05-26 23:06:25 +08:00
---
aliases:
2023-08-03 21:53:13 +08:00
- ../../features/panels/annotations/
2022-12-10 00:36:04 +08:00
- ../../panels/visualizations/annotations/
- ../../visualizations/annotations/
2023-12-13 04:27:29 +08:00
description: Configure options for Grafana's annotations list visualization
2022-05-26 23:06:25 +08:00
keywords:
- grafana
- Annotations
- panel
- documentation
Explicitly set all front matter labels in the source files (#71548)
* Set every page to have defaults of 'Enterprise' and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration pages to have of 'Cloud', 'Enterprise', and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/enterprise-licensing pages to have 'Enterprise' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/organization-management pages to have 'Enterprise' and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/provisioning pages to have 'Enterprise' and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/recorded-queries pages to have labels cloud,enterprise
* Set administration/roles-and-permissions/access-control pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/stats-and-license pages to have labels cloud,enterprise
* Set alerting pages to have labels cloud,enterprise,oss
* Set breaking-changes pages to have labels cloud,enterprise,oss
* Set dashboards pages to have labels cloud,enterprise,oss
* Set datasources pages to have labels cloud,enterprise,oss
* Set explore pages to have labels cloud,enterprise,oss
* Set fundamentals pages to have labels cloud,enterprise,oss
* Set introduction/grafana-cloud pages to have labels cloud
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Fix introduction pages products
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set panels-visualizations pages to have labels cloud,enterprise,oss
* Set release-notes pages to have labels cloud,enterprise,oss
* Set search pages to have labels cloud,enterprise,oss
* Set setup-grafana/configure-security/audit-grafana pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set setup-grafana/configure-security/configure-authentication pages to have labels cloud,enterprise,oss
* Set setup-grafana/configure-security/configure-authentication/enhanced-ldap pages to have labels cloud,enterprise
* Set setup-grafana/configure-security/configure-authentication/saml pages to have labels cloud,enterprise
* Set setup-grafana/configure-security/configure-database-encryption/encrypt-secrets-using-hashicorp-key-vault pages to have labels cloud,enterprise
* Set setup-grafana/configure-security/configure-request-security pages to have labels cloud,enterprise,oss
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set setup-grafana/configure-security/configure-team-sync pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set setup-grafana/configure-security/export-logs pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set troubleshooting pages to have labels cloud,enterprise,oss
* Set whatsnew pages to have labels cloud,enterprise,oss
* Apply updated labels from review
Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com>
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
---------
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com>
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
2023-07-18 16:10:12 +08:00
labels:
products:
- cloud
- enterprise
- oss
2023-09-22 22:27:16 +08:00
title: Annotations list
2023-09-01 02:31:37 +08:00
weight: 100
2022-05-26 23:06:25 +08:00
---
2021-07-22 04:25:32 +08:00
2023-09-22 22:27:16 +08:00
# Annotations list
2021-07-22 04:25:32 +08:00
2023-09-22 22:27:16 +08:00
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.
2021-07-29 08:06:42 +08:00
## Annotation query
2021-08-06 21:52:36 +08:00
The following options control the source query for the list of annotations.
2021-07-29 08:06:42 +08:00
### Query Filter
Use the query filter to create a list of annotations from all dashboards in your organization or the current dashboard in which this panel is located. It has the following options:
2021-08-06 21:52:36 +08:00
- All dashboards - List annotations from all dashboards in the current organization.
- This dashboard - Limit the list to the annotations on the current dashboard.
2021-07-29 08:06:42 +08:00
### Time Range
Use the time range option to specify whether the list should be limited to the current time range. It has the following options:
2021-08-06 21:52:36 +08:00
- None - no time range limit for the annotations query.
2023-09-22 22:27:16 +08:00
- This dashboard - Limit the list to the time range of the dashboard where the annotations list is available.
2021-07-29 08:06:42 +08:00
### Tags
2021-08-06 21:52:36 +08:00
Use the tags option to filter the annotations by tags. You can add multiple tags in order to refine the list.
2021-07-29 08:06:42 +08:00
2023-05-23 04:45:28 +08:00
{{% admonition type="note" %}}
Optionally, leave the tag list empty and filter on the fly by selecting tags that are listed as part of the results on the panel itself.
{{% /admonition %}}
2021-07-29 08:06:42 +08:00
### Limit
Use the limit option to limit the number of results returned.
## Display
2023-09-22 22:27:16 +08:00
These options control additional meta-data included in the annotations list display.
2021-07-29 08:06:42 +08:00
### Show user
2021-08-06 21:52:36 +08:00
Use this option to show or hide which user created the annotation.
2021-07-29 08:06:42 +08:00
### Show time
Use this option to show or hide the time the annotation creation time.
### Show Tags
2023-09-22 22:27:16 +08:00
Use this option to show or hide the tags associated with an annotation. _NB_ : You can use the tags to live-filter the annotations list on the visualization itself.
2021-07-29 08:06:42 +08:00
## Link behavior
### Link target
Use this option to chose how to view the annotated data. It has the following options.
2021-08-06 21:52:36 +08:00
- Panel - This option will take you directly to a full-screen view of the panel with the corresponding annotation
- Dashboard - This option will focus the annotation in the context of a complete dashboard
2021-07-29 08:06:42 +08:00
### Time before
2021-08-06 21:52:36 +08:00
Use this option to set the time range before the annotation. Use duration string values like "1h" = 1 hour, "10m" = 10 minutes, etc.
2021-07-29 08:06:42 +08:00
### Time after
Use this option to set the time range after the annotation.