From 8c2fec5bd44c31af13f9bc489ae1d2640af695f7 Mon Sep 17 00:00:00 2001 From: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com> Date: Mon, 29 Mar 2021 19:14:13 -0400 Subject: [PATCH] Updated docs for issue 32378 (#32462) * Reorganized content. * More changes. * More content reorg and added image links. --- docs/sources/datasources/_index.md | 4 +-- docs/sources/datasources/add-a-data-source.md | 28 ++++++++++++------- docs/sources/menu.yaml | 0 3 files changed, 20 insertions(+), 12 deletions(-) create mode 100644 docs/sources/menu.yaml diff --git a/docs/sources/datasources/_index.md b/docs/sources/datasources/_index.md index 8e089e0d768..f123740e4df 100644 --- a/docs/sources/datasources/_index.md +++ b/docs/sources/datasources/_index.md @@ -6,11 +6,11 @@ weight = 60 # Data sources -Grafana supports many different storage backends for your time series data (data source). Each data source has a specific Query Editor that is customized for the features and capabilities that the particular data source exposes. +Grafana supports many different storage backends for your time series data (data source). Refer to [Add a data source]({{< relref "add-a-data-source.md" >}}) for instructions on how to add a data source to Grafana. Only users with the organization admin role can add data sources. ## Querying -The query language and capabilities of each data source are obviously very different. You can combine data from multiple data sources onto a single Dashboard, but each Panel is tied to a specific data source that belongs to a particular Organization. +Each data source has a specific Query Editor that is customized for the features and capabilities that the particular data source exposes. The query language and capabilities of each data source are obviously very different. You can combine data from multiple data sources onto a single Dashboard, but each Panel is tied to a specific data source that belongs to a particular Organization. ## Supported data sources diff --git a/docs/sources/datasources/add-a-data-source.md b/docs/sources/datasources/add-a-data-source.md index 22a7783e4cf..39e5c4915d0 100644 --- a/docs/sources/datasources/add-a-data-source.md +++ b/docs/sources/datasources/add-a-data-source.md @@ -6,23 +6,31 @@ weight = 100 # Add a data source -Before you create your first dashboard, you need to add your data source. Following are the list of instructions to create one. +Before you can create your first dashboard, you need to add your data source. > **Note:** Only users with the organization Admin role can add data sources. -1. Move your cursor to the cog on the side menu which will show you the configuration menu. If the side menu is not visible click the Grafana icon in the upper left corner. Click on **Configuration** > **Data Sources** in the side menu and you'll be taken to the data sources page - where you can add and edit data sources. You can also click the cog. -{{< docs-imagebox img="/img/docs/v52/sidemenu-datasource.png" max-width="250px" class="docs-image--no-shadow">}} +To add a data source: -1. Click **Add data source** and you will come to the settings page of your new data source. +1. Move your cursor to the cog icon on the side menu which will show the configuration options. + + {{< docs-imagebox img="/img/docs/v75/sidemenu-datasource-7-5.png" max-width="150px" class="docs-image--no-shadow">}} - {{< docs-imagebox img="/img/docs/v52/add-datasource.png" max-width="700px" class="docs-image--no-shadow">}} +1. Click on **Data Sources**. The data sources page opens showing a list of previously configured data sources for the Grafana instance. -1. In the **Name** box, enter a name for this data source. +1. Click **Add data source** to see a list of all supported data sources. + + {{< docs-imagebox img="/img/docs/v75/add-data-source-7-5.png" max-width="600px" class="docs-image--no-shadow">}} + +1. Search for a specific data source by entering the name in the search dialog. Or you can scroll through supported data sources grouped into time series, logging, tracing and other categories. - {{< docs-imagebox img="/img/docs/v52/datasource-settings.png" max-width="700px" class="docs-image--no-shadow">}} +1. Move the cursor over the data source you want to add. + + {{< docs-imagebox img="/img/docs/v75/select-data-source-7-5.png" max-width="700px" class="docs-image--no-shadow">}} + +1. Click **Select**. The data source configuration page opens. + +1. Configure the data source following instructions specific to that data source. See [Data sources]({{< relref "_index.md" >}}) for links to configuration instructions for all supported data sources. -1. In the **Type**, select the type of data source. See [Supported data sources]({{< relref "_index.md#supported-data-sources" >}}) for more information and how to configure your data source settings. -1. Click **Save & Test**. diff --git a/docs/sources/menu.yaml b/docs/sources/menu.yaml new file mode 100644 index 00000000000..e69de29bb2d