opensearch-docs-cn/_dashboards/visualize/visbuilder.md

58 lines
2.8 KiB
Markdown
Raw Normal View History

---
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.
Heres 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">