From e42c3ee55e65569f2ee66ea4da3a0b8473a44e27 Mon Sep 17 00:00:00 2001 From: Adela Almasan <88068998+adela-almasan@users.noreply.github.com> Date: Mon, 22 May 2023 11:24:32 -0500 Subject: [PATCH] Docs: Update with annotations filtering and time regions (#68591) --- .../annotate-visualizations/index.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/sources/dashboards/build-dashboards/annotate-visualizations/index.md b/docs/sources/dashboards/build-dashboards/annotate-visualizations/index.md index e55bd8ad2ee..8291b6335da 100644 --- a/docs/sources/dashboards/build-dashboards/annotate-visualizations/index.md +++ b/docs/sources/dashboards/build-dashboards/annotate-visualizations/index.md @@ -78,6 +78,22 @@ In Grafana v5.3+ it's possible to use template variables in the tag query. So if {{< figure src="/static/img/docs/annotations/annotation_tag_filter_variable-8-1-0.png" max-width="600px" >}} +### Filter by panel + +You can configure which panels to apply annotations to by choosing an option from the _Show in_ section. You can apply the annotations to `All panels` that support annotations, or filter specific panels by choosing `Selected panels` or `All panels except`. The annotations will be displayed accordingly. + +{{< figure src="/media/docs/grafana/screenshot-grafana-10-0-annotation-filtering.png" max-width="600px" caption="Annotation filtering" >}} + +### Add time region + +When adding or editing an annotation, you can define a repeating time region by setting _Query type_ to `Time regions` - simply define the _From_/_To_ sections with the preferred days of the week and time. You also have the possibility to change the timezone - the default being set to dashboard's timezone. + +{{< figure src="/media/docs/grafana/screenshot-grafana-10-0-time-regions-annotations.png" max-width="600px" caption="Time regions business hours" >}} + +The above configuration will produce the following result in the Time series panel: + +{{< figure src="/media/docs/grafana/screenshot-grafana-10-0-timeseries-time-regions.png" max-width="600px" caption="Time series time regions business hours" >}} + ## Querying other data sources Annotation events are fetched via annotation queries. To add a new annotation query to a dashboard