Merge pull request #7074 from MicrosoftDocs/main

Auto Publish – main to live - 2025-08-28 11:00 UTC

Author: learn-build-service-prod[bot]

data-explorer/azure-data-explorer-dashboard-share.md

@@ -3,7 +3,7 @@ title: Share Azure Data Explorer dashboards
 description: Learn how to share Azure Data Explorer dashboards
 ms.reviewer: gabil
 ms.topic: how-to
-ms.date: 01/14/2025
+ms.date: 08/26/2025
 ---
 # Share dashboards
 
@@ -23,26 +23,29 @@ In general, dashboards are shared in two steps: Grant permissions, and share the
 ## Manage permissions
 
 1. Browse to your [Azure Data Explorer dashboards](azure-data-explorer-dashboards.md) and toggle mode from **Viewing** to **Editing**.
+
+    :::image type="content" source="media/dashboard-parameters/edit-dashboard.png" alt-text="Screenshot of the Dashboard's homepage." lightbox="media/dashboard-explore-data/dashboards.png":::
+
 1. Select the **Share** menu item in the top bar of the dashboard.
-1. Select **Manage permissions** from the dropdown.
+1. Select **Manage access** from the dropdown.
 
     :::image type="content" source="media/adx-dashboards/share-dashboard.png" alt-text="Screenshot of the share dashboard dropdown.":::
 
-## Grant permissions
+## Grant access
 
-Permissions can be granted to users [within your tenant](#grant-permissions-to-users-within-your-tenant) or to [users in a different tenant](#grant-permissions-to-users-in-a-different-tenant).
+Access can be granted to users [within your tenant](#grant-access-to-users-within-your-tenant) or to [users in a different tenant](#grant-access-to-users-in-a-different-tenant).
 
-### Grant permissions to users within your tenant
+### Grant access to users within your tenant
 
-In the **Dashboard permissions** pane:
+In the **Manage access** pane:
 
 1. Enter the Microsoft Entra user or Microsoft Entra group in **Add new members**.
 1. In the **Permission** level, select one of the following values: **Can view** or **Can edit**.
 1. Select **Add**.
 
-:::image type="content" source="media/dashboard-explore-data/dashboard-permissions.png" alt-text="Manage dashboard permissions.":::
+:::image type="content" source="media/adx-dashboards/dashboard-permissions.png" alt-text="Manage dashboard permissions.":::
 
-### Grant permissions to users in a different tenant
+### Grant access to users in a different tenant
 
 > [!IMPORTANT]
 > Cross-tenant sharing is disabled by default. To enable cross-tenant sharing, a tenant admin must enable it in the Azure Data Explorer WebUI [settings](web-customize-settings.md#enable-cross-tenant-dashboard-sharing).
@@ -52,7 +55,7 @@ In the **Dashboard permissions** pane:
 In the **Dashboard permissions** pane:
 
 1. Select the **Share** menu item in the top bar of the dashboard.
-1. Under **Share with external user**, enter the user's email address. 
+1. Under **Share with external user**, enter the user's email address.
 
     > [!NOTE]
     > * You can share with individual Microsoft Entra ID users, security groups, or Microsoft accounts (MSA).
@@ -100,7 +103,7 @@ To change a user permission level in the **Dashboard permissions** pane:
 1. Change the **Permission** level as needed.
 1. To remove a user, select the trash icon next to the user.
 
-:::image type="content" source="media/adx-dashboards/dashboard-permissions.png" alt-text="Screenshot of dashboard permissions dialog":::
+:::image type="content" source="media/adx-dashboards/view-dashboard-permissions.png" alt-text="Screenshot of the dashboard permissions dialog.":::
 
 ## Share the dashboard link
 

data-explorer/azure-data-explorer-dashboards.md

@@ -3,7 +3,7 @@ title: Visualize data with the Azure Data Explorer dashboard
 description: Learn how to visualize data with the Azure Data Explorer dashboard
 ms.reviewer: gabil
 ms.topic: how-to
-ms.date: 01/14/2025
+ms.date: 08/25/2025
 ---
 
 # Visualize data with Azure Data Explorer dashboards
@@ -41,11 +41,11 @@ To interactively explore sample dashboards, see [Quickstart: Visualize sample da
 
 A single dashboard can show visuals from one or more clusters.
 
-1. Select the **More menu** [...] > **Data sources**
+1. In the upper toolbar, select **Data sources**.
 
-    :::image type="content" source="media/adx-dashboards/data-source-more-menu.png" alt-text="Screenshot of adding a data source through the more menu.":::
+    :::image type="content" source="media/adx-dashboards/data-source.png" alt-text="Screenshot of adding a data source through the more menu.":::
 
-1. In the **Data sources** pane, select **+ New data source**.
+1. In the **Data sources** pane, select **+ Add**.
 1. In the **Create new data source** pane:
     1. Enter a **Data source name**.
     1. Enter the **Cluster URI** region and then select **Connect**.
@@ -59,26 +59,25 @@ A single dashboard can show visuals from one or more clusters.
 
 Dashboard tiles use Kusto Query Language snippets to retrieve data and render visuals. Each tile/query can support a single visual.
 
-1. Select **Add tile** from the dashboard canvas or the top menu bar.
+1. Select **Add tile** from the dashboard canvas or the upper toolbar.
 
-    :::image type="content" source="media/adx-dashboards/empty-dashboard-new-query.png" alt-text="New query.":::
+    :::image type="content" source="media/adx-dashboards/add-tile.png" alt-text="New query.":::
 
 1. In the **Query** pane,
     1. Select the data source from the dropdown menu.
     1. Type the query, and the select **Run**. For more information about generating queries that use parameters, see [Use parameters in your query](dashboard-parameters.md#use-parameters-in-your-query).
 
-    1. Select **Visual**.
-
-    :::image type="content" source="media/adx-dashboards/initial-query.png" alt-text="Execute query.":::
+         :::image type="content" source="media/adx-dashboards/run-query.png" alt-text="Execute query.":::
 
-1. In the visual tab, select **Visual type** to choose the type of visual.
-1. Select **Apply changes** to pin the visual to the dashboard.
+    1. Select **Visual**.
+    1. In the visual pane, select **Visual type** to choose the type of visual.
+    1. Select **Apply changes** to pin the visual to the dashboard.
 
-    :::image type="content" source="media/adx-dashboards/add-visual.png" alt-text="Add visual to query.":::
+    :::image type="content" source="media/adx-dashboards/visual.png" alt-text="Add visual to query.":::
 
 1. You can resize the visual and then select the **Save** icon.
 
-    :::image type="content" source="media/adx-dashboards/save-dashboard.png" alt-text="save dashboard.":::
+    :::image type="content" source="media/adx-dashboards/resize-and-save.png" alt-text="Resize and save dashboard.":::
 
 ## Pin tile from query
 
@@ -111,6 +110,9 @@ You can change the position of the legend in your tiles and use the legend to in
 
 If you have edit rights on a dashboard, you can change the location of the legend in your tile. Toggle to **Edit** mode and select the **Edit tile** pencil icon. In the **Visual formatting** pane, under **Legend**, you can select your location preference.
 
+:::image type="content" source="media/adx-dashboards/legend.png" alt-text="Screenshot of the legend settings in the Visual Formatting pane":::
+
+
 ### Interact with your data
 
 You can use the legend to interact with the data in your tile. You can change what data you view by selecting the specific item in the legend. Use <kbd>Ctrl</kbd> to add or remove items from the selection, hold <kbd>shift</kbd> to select a range. Items not selected are greyed out.
@@ -123,7 +125,7 @@ The **Up** and **Down** arrows navigate through the list in the following ways:
 * When one item is selected, the up and down arrows select the previous or next item.
 * When more than one item is selected, the up and down arrows change which item is highlighted on the tile. 
 
-:::image type="content" source="media/adx-dashboards/interactive-legend.png" alt-text="Screenshot showing the buttons to use the legend to interact with your data.":::
+:::image type="content" source="media/adx-dashboards/interactive-tile.png" alt-text="Screenshot showing the buttons to use the legend to interact with your data.":::
 
 ## View query
 
@@ -132,10 +134,11 @@ You can view the query in either editing or viewing mode. Editing the underlying
 1. Browse to your dashboard.
 1. On the tile you want to explore, select the **More menu [...]** > **View query**.
 
-    A pane opens with the query and results table.
-1. Select **New query tab**. Proceed to edit the query in the [Azure Data Explorer web UI query pane](web-ui-query-overview.md).
+:::image type="content" source="media/adx-dashboards/view-query.png" alt-text="Screenshot of the tile's dropdown menu with the View query option highlighted.":::
+
+1. In the **View Area** pane, select **New query tab** to edit the query in the [Azure Data Explorer web UI query pane](web-ui-query-overview.md). To edit the query within the tile, select the **Edit tile** button.
 
-:::image type="content" source="media/adx-dashboards/view-query.png" alt-text="Screenshot of view query pane with the query in the top half of the screen and results in the bottom half.":::
+:::image type="content" source="media/adx-dashboards/edit-query-pane.png" alt-text="Screenshot of view query pane with the query in the top half of the screen and results in the bottom half.":::
 
 > [!NOTE]
 > Any edits made to the query using this flow won't be reflected in the original dashboard.
@@ -148,9 +151,9 @@ Use the file menu to export a dashboard to a JSON file. Exporting dashboard can
 * **Dashboard template**: You can use the file as template for creating new dashboards.
 * **Manual editing**: You can edit the file to modify the dashboard. The file can be imported back to the dashboard.
 
-To export a dashboard, in the dashboard, select **File** > **Export to file**.
+To export a dashboard, in the upper toolbar, select **File** > **Download dashboard to file**.
 
-:::image type="content" source="media/adx-dashboards/export-dashboard-file.png" alt-text="Screenshot of dashboard, showing the export to file option.":::
+:::image type="content" source="media/adx-dashboards/export-dashboard.png" alt-text="Screenshot of dashboard, showing the export to file option.":::
 
 The file contains the dashboard data in JSON format, an outline of which is shown in the following snippet.
 
@@ -205,9 +208,9 @@ The file contains the dashboard data in JSON format, an outline of which is show
 
 You can use a dashboard file to create a new dashboard, as follows:
 
-1. In the main dashboard page, select **New dashboard** > **Import from file**.
+1. In the main **Dashboards** page, select **New dashboard** > **Import dashboard from file**.
 
-    :::image type="content" source="media/adx-dashboards/import-dashboard-file.png" alt-text="Screenshot of dashboard, showing the import from file option.":::
+    :::image type="content" source="media/adx-dashboards/new-dashboard-from-file.png" alt-text="Screenshot of dashboard, showing the import from file option.":::
 
 1. Select the file to import.
 1. Enter a dashboard name, and then select **Create**.
@@ -216,9 +219,9 @@ You can use a dashboard file to create a new dashboard, as follows:
 
 You can update an existing dashboard, or restore a previous version, as follows:
 
-1. In the dashboard, select **File** > **Replace with file**.
+1. In the upper toolbar, select **File** > **Replace dashboard with file**.
 
-    :::image type="content" source="media/adx-dashboards/replace-dashboard-file.png" alt-text="Screenshot of dashboard, showing the option to replace with file.":::
+    :::image type="content" source="media/adx-dashboards/existing-dashboard-from-file.png" alt-text="Screenshot of dashboard, showing the option to replace with file.":::
 
 1. Select the file to update the dashboard.
 1. Select **Save changes**.
@@ -229,31 +232,26 @@ Pages are optional containers for tiles. You can use pages to organize tiles int
 
 1. On the left **Pages** pane, select **+ Add page**.
 
+:::image type="content" source="media/adx-dashboards/add-page.png" alt-text="Screenshot of the add page button.":::
+
 1. To name the page, select the vertical **More menu [...]** > **Rename page**.
 
 1. [Add tiles](#add-tile) to the page.
 
-## Enable auto refresh
+## Enable Auto Refresh
 
-Auto refresh is a feature that allows you to automatically update the data on a dashboard without manually reloading the page or clicking a refresh button.
+Auto refresh keeps your dashboard data up-to-date without requiring manual updates. Database editors can configure a default refresh rate and set a minimum refresh interval to manage cluster load. Dashboard viewers can adjust the refresh rate within the allowed range to suit their needs.
 
-The default auto refresh rate can be set by a database editor. Both editors and viewers can change the actual rate of auto refresh while viewing a dashboard.
-
-:::image type="content" source="media/adx-dashboards/auto-refresh-times.png" alt-text="Screenshot of the different time intervals available in auto refresh in dashboards.":::
-
-However, database editors might want to limit the minimum refresh rate that any viewer can set so as to reduce the cluster load. When the minimum refresh rate is set, database users can't set a refresh rate lower than the minimum.
-
-1. Select the **More menu [...]** > **Auto refresh**.
+1. In the upper toolbar, select **Settings** > **Auto refresh**.
 
     :::image type="content" source="media/adx-dashboards/auto-refresh.png" alt-text="Select auto refresh.":::
 
 1. Toggle the option so auto refresh is **Enabled**.
 1. Select values for **Minimum time interval** and **Default refresh rate**.
-
-    :::image type="content" source="media/adx-dashboards/auto-refresh-toggle.png" alt-text="Enable auto refresh.":::
-
 1. Select **Apply** and then **Save** the dashboard.
 
+    :::image type="content" source="media/adx-dashboards/enable-auto-refresh.png" alt-text="Screenshot showing enable auto refresh.":::
+
 ## Related content
 
 * [Use parameters in Azure Data Explorer dashboards](dashboard-parameters.md)

data-explorer/base-query.md

@@ -3,7 +3,7 @@ title: Create a dashboard base query
 description: Learn how to create a base query for an Azure Data Explorer dashboard.
 ms.reviewer: gabil
 ms.topic: how-to
-ms.date: 04/30/2024
+ms.date: 08/26/2025
 ---
 # Create a dashboard base query
 
@@ -25,13 +25,16 @@ To interactively explore sample dashboards, see [Quickstart: Visualize sample da
 ## Create a base query
 
 1. Toggle the dashboard mode from **Viewing** to **Editing**.
+
+    :::image type="content" source="media/dashboard-parameters/edit-dashboard.png" alt-text="Screenshot of the Dashboard's homepage." lightbox="media/dashboard-explore-data/dashboards.png":::
+
 1. At the top of the dashboard, select **Base queries**.
 
     :::image type="content" source="media/base-query/base-query-menu.png" alt-text="Screenshot of dashboard menu in Azure Data Explorer with the base queries option highlighted by a red box." lightbox="media/base-query/base-query-menu.png":::
 
     The base query pane opens to the right.
 
-1. Select **+ New base query**.
+1. Select **+ Add**.
 
     :::image type="content" source="media/base-query/new-base-query.png" alt-text="Screenshot of new base query in Azure Data Explorer dashboards." lightbox="media/base-query/new-base-query.png":::
 

data-explorer/dashboard-conditional-formatting.md

@@ -3,7 +3,7 @@ title: Apply conditional formatting to Azure Data Explorer dashboard visuals
 description: Learn how to apply conditional formatting to Azure Data Explorer dashboard visuals.
 ms.reviewer: gabil
 ms.topic: how-to
-ms.date: 09/21/2023
+ms.date: 08/26/2025
 ---
 
 # Apply conditional formatting to Azure Data Explorer dashboard visuals
@@ -21,19 +21,19 @@ For each visual, you have the flexibility to define one or more conditional form
 
 1. On the tile that you'd like to customize, select the **Edit** icon.
 
-1. In the **Visual formatting** pane, scroll to the bottom and toggle **Conditional formatting** from **Hide** to **Show**.
-
-    :::image type="content" source="media/dashboard-customize-visuals/add-conditional-formatting.png" alt-text="Screenshot of adding conditional formatting in dashboards in Azure Data Explorer web UI.":::
+    :::image type="content" source="media/dashboard-customize-visuals/edit-tile-button.png" alt-text="Screenshot of how to edit a tile in dashboards in Azure Data Explorer web UI.":::
 
+1. In the **Visual formatting** pane, scroll to the bottom and toggle **Conditional formatting** from **Hide** to **Show**.
 1. Select **Add rule**. A new rule appears with default values.
 
+    :::image type="content" source="media/dashboard-customize-visuals/enable-formatting.png" alt-text="Screenshot of adding conditional formatting in dashboards in Azure Data Explorer web UI.":::
+
 1. On the new rule, select the **Edit** icon.
 
-    :::image type="content" source="media/dashboard-customize-visuals/edit-new-rule.png" alt-text="Screenshot of editing new rule in dashboards in Azure Data Explorer.":::
+    :::image type="content" source="media/dashboard-customize-visuals/edit-rule.png" alt-text="Screenshot of editing new rule in dashboards in Azure Data Explorer.":::
 
     The **Conditional formatting** pane opens. For table visuals, you can either [color by condition](#color-by-condition) or [color by value](#color-by-value). For stat and multi stat visuals, you can only [color by condition](#color-by-condition).
 
-
 ## Color by condition
 
 The color by condition rule allows you to set one or more logical conditions that must be met for a value to be colored. This option is available for table, stat, and multi stat visuals.
@@ -66,9 +66,9 @@ To color your results by condition:
     > [!NOTE]
     > To define more than one condition, select **Add condition** at the end of the **Conditions** section.
 
-1. Select **Save**. In the following example, the `State` column is highlighted when the `Damage` column is greater than zero.
+1. Select **Save**. In the following example, the `avg_Value` column is highlighted when the value is greater than 1,000.
 
-    :::image type="content" source="media/dashboard-customize-visuals/color-by-condition.png" alt-text="Screenshot of resulting graph from color by condition.":::
+    :::image type="content" source="media/dashboard-customize-visuals/condition.png" alt-text="Screenshot of resulting graph from color by condition.":::
 
 ## Color by value
 
@@ -90,9 +90,9 @@ To color your results by value:
     | **Reverse colors** |  | A toggle option that defines the direction of the gradient. |
     | **Apply options** |  :heavy_check_mark: | Apply the formatting to cells in a specific column or to the entire row. |
 
-1. Select **Save**. In the following example, the color changes based on the value in the `Event` column.
+1. Select **Save**. In the following example, the color changes based on the value in the `MetricType` column.
 
-    :::image type="content" source="media/dashboard-customize-visuals/color-by-value-results.png" alt-text="Screenshot of results for coloring by value.":::
+    :::image type="content" source="media/dashboard-customize-visuals/value.png" alt-text="Screenshot of results for coloring by value.":::
 
 ## Related content