58 lines
2.8 KiB
Markdown
58 lines
2.8 KiB
Markdown
---
|
||
layout: default
|
||
title: Using VisBuilder
|
||
parent: Building data visualizations
|
||
nav_order: 100
|
||
redirect_from:
|
||
- /dashboards/drag-drop-wizard/
|
||
---
|
||
|
||
# Using VisBuilder
|
||
|
||
VisBuilder is an experimental feature and shouldn't be used in a production environment. For updates on its progress, or if you want to leave feedback that helps improve the feature, see the [GitHub issue](https://github.com/opensearch-project/OpenSearch-Dashboards/issues/2280).
|
||
{: .warning}
|
||
|
||
You can use the VisBuilder visualization type in OpenSearch Dashboards to create data visualizations by using a drag-and-drop gesture. With VisBuilder you have:
|
||
|
||
* An immediate view of your data without the need to preselect the visualization output.
|
||
* The flexibility to change visualization types and index patterns quickly.
|
||
* The ability to easily navigate between multiple screens.
|
||
|
||
<img src="{{site.url}}{{site.baseurl}}/images/dashboards/vis-builder-2.png" alt="VisBuilder new visualization start page">
|
||
|
||
## Try VisBuilder in the OpenSearch Dashboards playground
|
||
|
||
If you'd like to try out VisBuilder without installing OpenSearch locally, you can do so in the [Dashboards playground](https://playground.opensearch.org/app/vis-builder#/). VisBuilder is enabled by default.
|
||
|
||
## Try VisBuilder locally
|
||
|
||
VisBuilder is enabled by default. If you want to disable it, set the feature `flag vis_builder.enabled:` to `false` in the `opensearch_dashboards.yml` file as follows:
|
||
|
||
```
|
||
# Set the value of this setting to false to disable VisBuilder
|
||
# functionality in Visualization.
|
||
vis_builder.enabled: false
|
||
```
|
||
|
||
Follow these steps to create a new visualization using VisBuilder in your environment:
|
||
|
||
1. Open Dashboards:
|
||
- If you're not running the Security plugin, go to http://localhost:5601.
|
||
- If you're running the Security plugin, go to https://localhost:5601 and log in with your username and password (default is admin/admin).
|
||
|
||
2. Confirm that the **Enable experimental visualizations** option is turned on.
|
||
- From the top menu, select **Management** > **Dashboards Management** > **Advanced Settings**.
|
||
- Select **Visualization** and verify that the option is turned on.
|
||
|
||
<img src="{{site.url}}{{site.baseurl}}/images/enable-experimental-viz.png" alt="Enable experimental visualizations" width="600">
|
||
|
||
3. From the top menu, select **Visualize** **>** **Create visualization** **>** **VisBuilder**.
|
||
|
||
<img src="{{site.url}}{{site.baseurl}}/images/dashboards/vis-builder-1.png" alt="Select the VisBuilder visualization type" width="550">
|
||
|
||
4. Drag and drop field names from the left column into the **Configuration** panel to generate a visualization.
|
||
|
||
Here’s an example visualization. Your visualization will look different depending on your data and the fields you select.
|
||
|
||
<img src="{{site.url}}{{site.baseurl}}/images/drag-drop-generated-viz.png" alt="Visualization generated using sample data">
|