Merge branch 'main' into fix-3214-create-dashboard

Author: alaudazzi

deploy-manage/cloud-organization/tools-and-apis.md

@@ -13,6 +13,8 @@ You can use the [{{ecloud}} API](https://www.elastic.co/docs/api/doc/cloud/) to
 * Refer to [](/deploy-manage/api-keys/elastic-cloud-api-keys.md) to learn how to generate an API key to access this API.
 * Refer to [{{ecloud}} RESTful API](cloud://reference/cloud-hosted/ec-api-restful.md) for usage information and examples.
 
+For additional billing and cost information for {{ecloud}}, you can use the [Cloud Billing API](https://www.elastic.co/docs/api/doc/cloud-billing/).
+
 For {{ecloud}} [service status](/deploy-manage/cloud-organization/service-status.md) updates, you can use the [Service Status API](https://status.elastic.co/api/).
 
 For information about all of the tools and APIs that you can use to manage your {{ech}} deployments and {{serverless-full}} projects, refer to [](/deploy-manage/deploy/elastic-cloud/tools-apis.md).

deploy-manage/deploy/elastic-cloud/tools-apis.md

@@ -33,6 +33,7 @@ The following REST APIs allow you to manage your {{ecloud}} organization, users,
 | {{ecloud}} organization<br><br>{{ech}} deployments | [{{ecloud}} API](https://www.elastic.co/docs/api/doc/cloud/) | Manage your Cloud organization, members, costs, billing, and more.<br><br>Manage your hosted deployments and all of the resources associated with them, including scaling or autoscaling resources, and managing network security, deployment extensions, remote clusters, and {{stack}} versions.<br><br>Refer to [{{ecloud}} RESTful API](cloud://reference/cloud-hosted/ec-api-restful.md) for usage information and examples. |
 | {{serverless-full}} projects | [{{serverless-full}} API](https://www.elastic.co/docs/api/doc/elastic-cloud-serverless) | Manage {{serverless-full}} projects. |
 | {{ecloud}} services | [Service Status API](https://status.elastic.co/api/) | Programmatically ingest [service status](/deploy-manage/cloud-organization/service-status.md) updates. |
+| {{ecloud}} billing information | [Cloud Billing API](https://www.elastic.co/docs/api/doc/cloud-billing/) | Retrieve additional billing and cost information about your {{ecloud}} organization. |
 
 
 ### APIs to interact with data and solution features

deploy-manage/security/private-connectivity-aws.md

@@ -301,7 +301,7 @@ If the policy doesn't contain a VPC filter, then the association can serve as a
 
 ## Access the deployment over a PrivateLink [ec-access-the-deployment-over-private-link]
 
-For traffic to connect with the deployment over Azure PrivateLink, the client making the request needs to be located within the VPC where you’ve created the VPC endpoint. You can also set up network traffic to flow through the originating VPC from somewhere else, such as another VPC or VPN from your corporate network. This assumes that the VPC endpoint and the DNS record are also available within that context. Check your service provider documentation for setup instructions.
+For traffic to connect with the deployment over AWS PrivateLink, the client making the request needs to be located within the VPC where you’ve created the VPC endpoint. You can also set up network traffic to flow through the originating VPC from somewhere else, such as another VPC or VPN from your corporate network. This assumes that the VPC endpoint and the DNS record are also available within that context. Check your service provider documentation for setup instructions.
 
 ::::{important}
 Use the alias you’ve set up as CNAME DNS record to access your deployment.
@@ -408,4 +408,4 @@ To delete a policy:
 
 :::{include} _snippets/network-security-page.md
 :::
-4. Find the policy you want to edit, then click the **Delete** icon. The icon is inactive if there are deployments associated with the policy.
+4. Find the policy you want to edit, then click the **Delete** icon. The icon is inactive if there are deployments associated with the policy.

explore-analyze/_snippets/import-discover-query-controls-into-dashboard.md

@@ -0,0 +1,17 @@
+To add a Discover query to a dashboard in a way that preserves the [controls created from Discover](/explore-analyze/discover/try-esql.md#add-variable-control-discover) and also adds them to the dashboard, do as follows:
+
+1. Save the {{esql}} query containing the variable control into a Discover session. If your Discover session contains several tabs, only the first tab will be imported to the dashboard.
+
+1. Go to **Dashboards** and open or create one.
+
+1. Select **Add**, then **From library**.
+
+1. Find and select the Discover session you saved earlier.
+
+A new panel appears on the dashboard with the results of the query along with any attached controls.
+
+![Importing Discover controls into a dashboard](/explore-analyze/images/import-discover-control-dashboard.png " =40%")
+
+:::{note}
+When you add a visualization to a dashboard using the {icon}`save` **Save visualization** option, controls are not added to the dashboard.
+:::

explore-analyze/_snippets/variable-control-examples.md

@@ -0,0 +1,25 @@
+**Examples**
+
+* Integrate filtering into your {{esql}} experience
+
+  ```esql
+  | WHERE field == ?value
+  ```
+
+* Fields in controls for dynamic group by
+
+  ```esql
+  | STATS count=COUNT(*) BY ??field
+  ```
+
+* Variable time ranges? Bind function configuration settings to a control
+
+  ```esql
+  | BUCKET(@timestamp, ?interval),
+  ```
+
+* Make the function itself dynamic
+
+  ```esql
+  | STATS metric = ??function
+  ```

explore-analyze/_snippets/variable-control-form.md

@@ -0,0 +1,11 @@
+* The type of the control. 
+  * For controls with **Static values**, enter available controls manually or select them from the dropdown list. 
+  * For controls with **Values from a query**, write an {{esql}} query to populate the list of options.
+* The name of the control. This name is used to reference the control in {{esql}} queries. 
+  * Start the name with `?` if you want the options to be simple static values.
+  * {applies_to}`stack: ga 9.1` Start the name with `??` if you want the options to be fields or functions.
+* The values users can select for this control. You can add multiple values from suggested fields, or type in custom values. If you selected **Values from a query**, you must instead write an {{esql}} query at this step.
+* The label of the control. This is the label displayed in **Discover** or in the dashboard.
+* The width of the control.
+
+  ![ESQL control settings](/explore-analyze/images/esql-visualization-control-settings.png "title =50%")

explore-analyze/alerts-cases/watcher/schedule-types.md

@@ -422,7 +422,7 @@ By default, the `yearly` schedule is evaluated in the UTC time zone. To use a di
 ## {{watcher}} cron schedule [schedule-cron]
 
 
-Defines a [`schedule`](trigger-schedule.md) using a [cron expression](elasticsearch://reference/elasticsearch/rest-apis/api-conventions.md#api-cron-expressions) that specifiues when to execute a watch.
+Defines a [`schedule`](trigger-schedule.md) using a [cron expression](elasticsearch://reference/elasticsearch/rest-apis/api-conventions.md#api-cron-expressions) that specifies when to execute a watch.
 
 ::::{tip}
 While cron expressions are powerful, a regularly occurring schedule is easier to configure with the other schedule types. If you must use a cron schedule, make sure you verify it with [`elasticsearch-croneval`](elasticsearch://reference/elasticsearch/command-line-tools/elasticsearch-croneval.md) .

explore-analyze/dashboards/add-controls.md

@@ -90,6 +90,10 @@ You can add one interactive time slider control to a dashboard.
 
 
 ## Add variable controls [add-variable-control]
+```{applies_to}
+stack: preview 9.0
+serverless: preview
+```
 
 :::{note}
 In versions `9.0` and `9.1`, variable controls are called {{esql}} controls.
@@ -113,17 +117,8 @@ Only **Options lists** are supported for {{esql}}-based controls. Options can be
 
 2. A menu opens to let you configure the control. This is where you can specify:
 
-    * The type of the control. 
-      * For controls with **Static values**, select the options available in the controls by entering them manually or by using a dropdown listing available values. 
-      * For controls with **Values from a query**, write an {{esql}} query to populate the list of options.
-    * The name of the control. This name is used to reference the control in {{esql}} queries. 
-      * Start the name with `?` if you want the options to be simple static values.
-      * Start the name with `??` if you want the options of the control to be fields or functions. {applies_to}`stack: ga 9.1`
-    * The values users can select for this control. You can add multiple values from suggested fields, or type in custom values. If you selected **Values from a query**, you must instead write an {{esql}} query at this step.
-    * The label of the control. This is the label displayed for users viewing the dashboard for that control.
-    * The width of the control.
-
-    ![ESQL control settings](/explore-analyze/images/esql-visualization-control-settings.png "title =50%")
+   :::{include} ../_snippets/variable-control-form.md
+   :::
 
 3. Save the control. 
 
@@ -132,34 +127,19 @@ If you added it by starting from a query, the control is directly inserted in th
 
 You can then insert it in any other {{esql}} visualization queries by typing the control's name.
 
+:::{include} ../_snippets/variable-control-examples.md
+:::
 
-**Examples**
-
-* Integrate filtering into your {{esql}} experience
-
-  ```esql
-  | WHERE field == ?value
-  ```
-
-* Fields in controls for dynamic group by
-
-  ```esql
-  | STATS count=COUNT(*) BY ?field
-  ```
-
-* Variable time ranges? Bind function configuration settings to a control
-
-  ```esql
-  | BUCKET(@timestamp, ?interval),
-  ```
-
-* Make the function itself dynamic
+![Editing {{esql}} controls from a dashboard](https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blte42dfaa404bfc2d6/67d2e31e2e4dc59da190d78f/dashboard-esql-controls.gif)
 
-  ```esql
-  | STATS metric = ?function
-  ```
+### Import a Discover query along with its controls into a dashboard
+```{applies_to}
+stack: preview 9.2
+serverless: preview
+```
 
-![Editing {{esql}} controls from a dashboard](https://images.contentstack.io/v3/assets/bltefdd0b53724fa2ce/blte42dfaa404bfc2d6/67d2e31e2e4dc59da190d78f/dashboard-esql-controls.gif)
+:::{include} ../_snippets/import-discover-query-controls-into-dashboard.md
+:::
 
 ## Configure the controls settings [configure-controls-settings]
 

explore-analyze/dashboards/arrange-panels.md

@@ -23,7 +23,7 @@ Organize your dashboard panels into collapsible sections to improve readability
 To add a collapsible section:
 
 1. Open the dashboard and make sure that you are in **Edit** mode.
-2. Select **Add panel** and select **Collapsible section**. The collapsible section is added at the end of the dashboard.
+2. Add a new panel and select **Collapsible section**. The collapsible section is added at the end of the dashboard.
 3. Optionally, edit the label of the section.
 4. Drag and drop any panels you want into the section.
    :::{tip}

explore-analyze/dashboards/duplicate-dashboards.md

@@ -11,7 +11,7 @@ products:
 # Duplicate a dashboard [duplicate-dashboards]
 
 1. Open the dashboard you want to duplicate.
-2. In **View** mode, click **Duplicate** in the toolbar.
+2. Exit the edit mode, and click **Duplicate** in the toolbar.
 3. In the **Duplicate dashboard** window, enter a title and optional description and tags.
 4. Click **Save**.