Docs move "visualizations" folder up one level in TOC (#38523) (#38563)

* Moved Visualizations folder one level up. Fixed a bunch of broken relrefs. * More broken relrefs. * Fixed the last of the broken relrefs * Adjusted weight and added alias. * Added aliases to a bunch of visualization topics. * More topics with aliases. * More aliases, adjusted some weight and other metadata information.
2021-08-25 14:58:24 -04:00
parent c65399eaad
commit 33a7e11344
52 changed files with 124 additions and 98 deletions
@@ -0,0 +1,72 @@
+++
+title = "Annotations"
+description = "Annotations visualization documentation"
+keywords = ["grafana", "Annotations", "panel", "documentation"]
+aliases = ["/docs/grafana/latest/features/panels/anotations/", "/docs/grafana/latest/panels/visualizations/annotations/"]
+weight = 105
+++
+
+# Annotations
+
+The Annotations panel 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.
+
+## Annotation query
+
+The following options control the source query for the list of annotations.
+
+### 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:
+
+- 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
+
+Use the time range option to specify whether the list should be limited to the current time range. It has the following options:
+
+- None - no time range limit for the annotations query.
+- This dashboard - Limit the list to the time range of the dashboard where the annotation list panel is available.
+
+### Tags
+
+Use the tags option to filter the annotations by tags. You can add multiple tags in order to refine the list.
+
+> **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.
+
+### Limit
+
+Use the limit option to limit the number of results returned.
+
+## Display
+
+These options control additional meta-data included in the annotations panel display.
+
+### Show user
+
+Use this option to show or hide which user created the annotation.
+
+### Show time
+
+Use this option to show or hide the time the annotation creation time.
+
+### Show Tags
+
+Use this option to show or hide the tags associated with an annotation. _NB_: You can use the tags to live-filter the annotation list on the panel itself.
+
+## Link behavior
+
+### Link target
+
+Use this option to chose how to view the annotated data. It has the following options.
+
+- 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
+
+### Time before
+
+Use this option to set the time range before the annotation. Use duration string values like "1h" = 1 hour, "10m" = 10 minutes, etc.
+
+### Time after
+
+Use this option to set the time range after the annotation.