From c25fc3469599eb283f99c3a34014439ce3d6d5cb Mon Sep 17 00:00:00 2001 From: "Grot (@grafanabot)" <43478413+grafanabot@users.noreply.github.com> Date: Wed, 1 Dec 2021 09:00:08 -0500 Subject: [PATCH] Docs: Adding panel suggestions initial documentation for 8.3 (#42488) (#42580) * Adding panel suggestions initial documentation for 8.3 * Update docs/sources/panels/add-a-panel.md Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> * Update docs/sources/visualizations/_index.md Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> (cherry picked from commit 5fd1ce0fe99dce001156aa04b9a0b95c96e33f63) Co-authored-by: Petros Kolyvas --- docs/sources/panels/add-a-panel.md | 5 ++--- docs/sources/visualizations/_index.md | 2 ++ 2 files changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/sources/panels/add-a-panel.md b/docs/sources/panels/add-a-panel.md index d0525455184..dbf6b0fa19f 100644 --- a/docs/sources/panels/add-a-panel.md +++ b/docs/sources/panels/add-a-panel.md @@ -25,12 +25,11 @@ Each panel needs at least one query to display a visualization. You write querie 1. Choose a data source. In the first line of the Query tab, click the drop-down list to see all available data sources. This list includes all data sources you added. Refer to [Add a data source]({{< relref "../datasources/add-a-data-source.md" >}}) if you need instructions. 1. Write or construct a query in the query language of your data source. Options will vary. Refer to your specific [data source documentation]({{< relref "../datasources/_index.md" >}}) for specific guidelines. -## 3. Choose a visualization type - -In the Visualization list, click a visualization type. Grafana displays a preview of your query results with that visualization applied. +## 3. Choose a visualization ![](/static/img/docs/panel-editor/select-visualization-8-0.png) +When you choose a visualization, Grafana will offer visualization suggestions based on your query. You can select from the available suggestions or you can pick a visualization from the complete list of supported visualizations. When you select a visualization, Grafana will show a preview of your query results with that visualization applied. For more information about individual visualizations, refer to [Visualizations options]({{< relref "../visualizations/_index.md" >}}). ## 4. (Optional) Edit panel settings diff --git a/docs/sources/visualizations/_index.md b/docs/sources/visualizations/_index.md index baa08e3e75a..623c4b90074 100644 --- a/docs/sources/visualizations/_index.md +++ b/docs/sources/visualizations/_index.md @@ -8,6 +8,8 @@ aliases = ["/docs/grafana/latest/panels/visualizations/"] Grafana offers a variety of visualizations to support different use cases. This section of the documentation highlights the built-in panels, their options and typical usage. +> **Note:** If you are unsure which visualization to pick, Grafana can provide visualization suggestions based on the panel query. When you select a visualization, Grafana will show a preview with that visualization applied. For more information, see the [add a panel]({{< relref "../pnaels/add-a-panel.md" >}}) documentation. + - Graphs & charts - [Time series]({{< relref "./time-series/_index.md" >}}) is the default and main Graph visualization. - [State timeline]({{< relref "./state-timeline.md" >}}) for state changes over time.