Update multiple data sources and add TSVB and Vega viz types

_dashboards/management/multi-data-sources.md

@@ -203,14 +203,15 @@ When the data source feature is enabled, you can navigate to **Search Relevance*
 
 After configuring multiple data sources, you can analyze the data from each source. Refer to the following resources for more information:
 
-- Learn about [managing index patterns]({{site.url}}{{site.baseurl}}/dashboards/management/index-patterns/) through OpenSearch Dashboards.
-- Learn about [indexing data using Index Management]({{site.url}}{{site.baseurl}}/dashboards/im-dashboards/index/) through OpenSearch Dashboards.
-- Learn about how to [connect OpenSearch and Amazon S3 through OpenSearch Dashboards]({{site.url}}{{site.baseurl}}/dashboards/management/S3-data-source/).
-- Learn about the [Integrations tool]({{site.url}}{{site.baseurl}}/integrations/index/), which gives you the flexibility to use various data ingestion methods and connect data from the Dashboards UI.
+- [Managing index patterns]({{site.url}}{{site.baseurl}}/dashboards/management/index-patterns/) through OpenSearch Dashboards.
+- [Indexing data using Index Management]({{site.url}}{{site.baseurl}}/dashboards/im-dashboards/index/) through OpenSearch Dashboards.
+- [Connect OpenSearch and Amazon S3 through OpenSearch Dashboards]({{site.url}}{{site.baseurl}}/dashboards/management/S3-data-source/).
+- [Integrations tool]({{site.url}}{{site.baseurl}}/integrations/index/), which gives you the flexibility to use various data ingestion methods and connect data from the OpenSearch Dashboards UI.
+- Creating [Vega]({{site.url}}{{site.baseurl}}/dashboards/visualize/vega/) and [TSVB]({{site.url}}{{site.baseurl}}/dashboards/visualize/tsvb/) visualizations.
 
 ## Limitations
 
 The following features are not supported when using multiple data sources:
 
 * Timeline visualization types
-* Some external plugins, such as the `gantt-chart` plugin
+* Certain external plugins, such as the `gantt-chart` plugin

_dashboards/visualize/area.md

@@ -1,6 +1,6 @@
 ---
 layout: default
-title: Using area charts
+title: Area charts
 parent: Building data visualizations
 nav_order: 5
 ---

_dashboards/visualize/gantt.md

@@ -1,6 +1,6 @@
 ---
 layout: default
-title: Using Gantt charts
+title: Gantt charts
 parent: Building data visualizations
 nav_order: 30
 redirect_from:
@@ -18,7 +18,7 @@ To create a Gantt chart, perform the following steps:
 1. In the visualizations menu, choose **Create visualization** and **Gantt Chart**.
 1. Choose a source for the chart (e.g. some log data).
 1. Under **Metrics**, choose **Event**. For log data, each log is an event.
-1. Select the **Start Time** and **Duration** fields from your data set. The start time is the timestamp for the beginning of an event. The duration is the amount of time to add to the start time.
+1. Select the **Start Time** and **Duration** fields from your dataset. The start time is the timestamp for the beginning of an event. The duration is the amount of time to add to the start time.
 1. Under **Results**, choose the number of events to display on the chart. Gantt charts sequence events from earliest to latest based on start time.
 1. Choose **Panel settings** to adjust axis labels, time format, and colors.
 1. Choose **Update**.

_dashboards/visualize/geojson-regionmaps.md

@@ -1,6 +1,6 @@
 ---
 layout: default
-title: Using coordinate and region maps
+title: Coordinate and region maps
 parent: Building data visualizations
 has_children: true
 nav_order: 15
@@ -12,7 +12,7 @@ redirect_from:
 
 OpenSearch has a standard set of GeoJSON files that provide a vector map with each region map. OpenSearch Dashboards also provides basic map tiles with a standard vector map to create region maps. You can configure the base map tiles using [Web Map Service (WMS)](https://www.ogc.org/standards/wms). For more information, see [Configuring WMS in OpenSearch Dashboards]({{site.url}}{{site.baseurl}}/dashboards/maptiles/). 
 
-For air gapped environments, OpenSearch Dashboards provides a self-host maps server. For more information, see [Using the self-host maps server]({{site.url}}{{site.baseurl}}/dashboards/selfhost-maps-server/)
+For air-gapped environments, OpenSearch Dashboards provides a self-host maps server. For more information, see [Using the self-host maps server]({{site.url}}{{site.baseurl}}/dashboards/selfhost-maps-server/)
 
 While you can't configure a server to support user-defined vector map layers, you can configure your own GeoJSON file and upload it for this purpose. 
 {: .note}
@@ -35,7 +35,7 @@ You can use [geojson.io](https://geojson.io/#map=2/20.0/0.0) to extract GeoJSON
 
 To create your own custom vector map, upload a JSON file that contains GEO data for your customized regional maps. The JSON file contains vector layers for visualization.
 
-1. Prepare a JSON file to upload. Make sure the file has either a .geojson or .json extension.
+1. Prepare a JSON file to upload. Make sure the file has either a `.geojson` or `.json` extension.
 1. On the top menu bar, go to **OpenSearch Dashboards > Visualize**.
 1. Select the **Create Visualization** button.
 1. Select **Region Map**.

_dashboards/visualize/maps-stats-api.md

@@ -3,7 +3,7 @@ layout: default
 title: Maps Stats API
 nav_order: 20
 grand_parent: Building data visualizations
-parent: Using coordinate and region maps 
+parent: Coordinate and region maps 
 has_children: false
 ---
 

_dashboards/visualize/maps.md

@@ -2,7 +2,7 @@
 layout: default
 title: Using maps 
 grand_parent: Building data visualizations
-parent: Using coordinate and region maps
+parent: Coordinate and region maps
 nav_order: 10
 redirect_from:
   - /dashboards/maps/

_dashboards/visualize/maptiles.md

@@ -2,7 +2,7 @@
 layout: default
 title: Configuring a Web Map Service (WMS)
 grand_parent: Building data visualizations
-parent: Using coordinate and region maps
+parent: Coordinate and region maps
 nav_order: 30
 redirect_from:
   - /dashboards/maptiles/

_dashboards/visualize/selfhost-maps-server.md

@@ -1,14 +1,14 @@
 ---
 layout: default
-title: Using the self-host maps server
+title: Using self-host maps servers
 grand_parent: Building data visualizations
-parent: Using coordinate and region maps
+parent: Coordinate and region maps
 nav_order: 40
 redirect_from:
   - /dashboards/selfhost-maps-server/
 ---
 
-# Using the self-host maps server
+# Using self-host maps servers
 
 The self-host maps server for OpenSearch Dashboards allows users to access the default maps service in air-gapped environments. OpenSearch-compatible map URLs include a map manifest with map tiles and vectors, the map tiles, and the map vectors.
 

_dashboards/visualize/tsvb.md

@@ -0,0 +1,71 @@
+---
+layout: default
+title: TSVB
+parent: Building data visualizations
+nav_order: 45
+---
+
+# TSVB
+
+The Time-Series Visual Builder (TSVB) is a powerful data visualization tool in OpenSearch Dashboards that allows you to create detailed time-series visualizations. One of its key features is the ability to add annotations or markers at specific time points based on index data. This feature is particularly useful for making connections between multiple indexes and building visualizations that display data over time, such as flight status, delays by type, and more. TSVB currently supports the following visualization types: Area, Line, Metric, Gauge, Markdown, and Data Table.
+
+## Creating TSVB visualizations from multiple data sources
+Introduced 2.14
+{: .label .label-purple }
+
+Before proceeding, ensure that the following configurations are enabled. These can be found in `config/opensearch_dasboards.yaml`:
+
+```yaml
+data_source.enabled: true
+vis_type_timeseries.enabled: true
+```
+{% include copy-curl.html %}
+
+Once you have configured [multiple data sources]({{site.url}}{{site.baseurl}}/dashboards/management/multi-data-sources/) in OpenSearch Dashboards, you can use Vega to query those data sources. The following GIF shows the process of creating TSVB visualizations in OpenSearch Dashboards.
+
+![Process of creating TSVB visualizations in OpenSearch Dashboards]({{site.url}}{{site.baseurl}}/images/dashboards/configure-tsvb.gif)
+
+**Step 1: Set up and connect data sources**
+
+Open OpenSearch Dashboards and follow these steps:
+
+1. Select **Dashboards Management** from the main menu on the left.
+2. Select **Data sources** and then select the **Create data source** button.
+3. From the **Create data source** page, enter the connection details and endpoint URL.
+4. From the **Home** page, select **Add sample data** and then select the **Add data** button for the **Sample web logs** dataset.
+
+The following GIF shows these steps.
+
+![Create data source]({{site.url}}{{site.baseurl}}/images/dashboards/create-datasource.gif)
+
+**Step 2: Create the visualization**
+
+Follow these steps to create the visualization:
+
+1. From the menu on the left, select **Visualize**.
+2. From the **Visualizations** page, select **Create Visualization** and then select **TSVB** in the pop-up window.
+3. Proceed with the steps under Specify data sources.
+
+**Step 3: Specify data sources**
+
+After creating a TSVB visualization, data may appear based on your default index pattern. To change the index pattern or configure additional settings, follow these steps to customize your visualization:
+
+1. From the **Create** window, select **Panel options**.
+2. From **Data source**, select the OpenSearch cluster from which to pull data. In this case, choose your newly created data source.
+3. From **Index name**, enter `opensearch_dashboards_sample_data_logs`.
+4. Under **Time field**, select `@timestamp`. This setting specifies the time range for rendering the visualization.
+
+**(Optional) Step 4: Add annotations**
+
+Annotations are markers that can be added to time-series visualizations. Follow these steps to add annotations:
+
+1. On the upper-left corner of the page, select **Time Series**.
+2. Select the **Annotations** tab and then **Add data source**.
+3. In the **Index** name field, specify the appropriate index. In this case, continue using the same index from the previous steps, that is, `opensearch_dashboards_sample_data_logs`.
+4. From **Time** field, select `@timestamp`.
+5. In **Fields**, enter timestamp.
+6. In **Row** template, enter timestamp.
+
+The visualization automatically updates to display your annotations, as shown in the following image.
+
+  <img src="{{site.url}}{{site.baseurl}}/images/dashboards/tsvb-with-annotations.png" alt="TSVB visualization with annotations" width="700"/>