[DOC] Add multidata source Dev Tools integration (#3653)

* Create new doc site section Dev Tools

Signed-off-by: vagimeli <vagimeli@amazon.com>
This commit is contained in:
Melissa Vagi 2023-04-25 15:06:06 -06:00 committed by GitHub
parent aa2033c863
commit 74902a24d8
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
5 changed files with 51 additions and 7 deletions

View File

@ -0,0 +1,14 @@
---
layout: default
title: Dev Tools
nav_order: 100
has_children: true
---
# Dev Tools
**Dev Tools** allows you to set up your OpenSearch Dashboards environment, identify and fix bugs, and customize your dashboards' appearance and behavior.
To access the Dev Tools console, select **Dev Tools** in the menu on the OpenSearch Dashboards home page. You'll see an interface like the one shown in the following image.
<img src="{{site.url}}{{site.baseurl}}/images/dashboards/dev-tools-console.png" alt="Dev Tools interface from home page">

View File

@ -1,10 +1,13 @@
---
layout: default
title: Running queries in the console
nav_order: 110
title: Running queries in the Dev Tools console
parent: Dev Tools
nav_order: 10
redirect_from:
- /dashboards/run-queries/
---
# Running queries in the console
# Running queries in the Dev Tools console
You can use the OpenSearch Dev Tools Console to send queries to OpenSearch.

View File

@ -2,7 +2,7 @@
layout: default
title: Adding multiple data sources
parent: Exploring data
nav_order: 5
nav_order: 20
---
# Adding multiple data sources
@ -10,18 +10,18 @@ nav_order: 5
The multiple data sources feature is an experimental feature released in OpenSearch 2.4. It can't be used in a production environment. For updates on the features progress or to leave feedback on improving the feature, see the [OpenSearch Forum discussion](https://forum.opensearch.org/t/feedback-experimental-feature-connect-to-external-data-sources/11144).
{: .warning }
You can add multiple data sources to a single dashboard. OpenSearch Dashboards allows you to dynamically manage data sources, create index patterns based on those data sources, and execute queries against a specific data source and then combine visualizations in one dashboard.
OpenSearch Dashboards allows you to dynamically manage data sources, create index patterns based on those data sources, run queries against a specific data source, and combine visualizations in one dashboard.
In this tutorial we provide the steps for enabling the `data_source` setting in Dashboards; adding credentials, data source connections, and index patterns; and combining visualizations in a single dashboard.
## Try it: Exploring the multiple data sources feature in your local environment
## Enabling the multiple data sources feature
This tutorial uses a preconfigured data source and index pattern, and you arent required to configure settings. However, youll need to enable the `data_source` setting in the configuration file before before getting started with exploring this feature.
{: .note }
The multiple data sources feature is experimental and can't be deployed into production. You can try it out with a sample data source and a sample index pattern. Before getting started, you must first edit the YAML configuration. The following section provides the steps for enabling the feature.
## Modifying the multiple data sources settings
## Modifying the YAML file settings for multiple data sources
Dashboards is configured in the cluster settings, and the multiple data sources feature is disabled by default. To enable it, you need to edit the configuration in `opensearch_dashboards.yml` and then restart the cluster.
@ -132,6 +132,33 @@ The following image shows a date histogram with an interval dropdown list.
<img src="{{site.url}}{{site.baseurl}}/images/multi-data-sources-11.jpg" alt="Histogram user interface">
## Selecting multiple data sources in the Dev Tools console
Selecting multiple data sources in the Dev Tools console allows you to work with a broader range of data and gain deeper insights into your code and applications. You can follow these steps:
1. Open `opensearch_dashboards.yml` in the editor of your choice.
2. Set `data_source.enabled:` to `true`, as shown in the following example:
```
# Set the value of this setting to true to enable the experimental multiple data source
# support feature. Use with caution.
data_source.enabled: true
```
3. Connect to OpenSearch Dashboards and select **Dev Tools** in the menu.
5. Enter the following query in the editor pane of the **Console** and then select the play button:
```json
GET /_cat/indices
```
6. From the **DataSource** dropdown menu, select a data source and then query the source.
7. Repeat the preceding steps for each data source you want to select.
For an overview of this process, watch the following 15-second video.
<img src="{{site.url}}{{site.baseurl}}/images/dashboards/multidata-dev-tools.gif" alt="Multiple data sources in Dev Tools demo">{: .img-fluid}
## Creating data visualizations for a dashboard
Follow these steps to learn how to create data visualizations for a dashboard:

Binary file not shown.

After

Width:  |  Height:  |  Size: 176 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.2 MiB