diff --git a/data-explorer/media/web-sync/sync-on-confirmation.png b/data-explorer/media/web-sync/sync-on-confirmation.png new file mode 100644 index 0000000000..50d56eed95 Binary files /dev/null and b/data-explorer/media/web-sync/sync-on-confirmation.png differ diff --git a/data-explorer/media/web-sync/sync-on-status.png b/data-explorer/media/web-sync/sync-on-status.png new file mode 100644 index 0000000000..3989202363 Binary files /dev/null and b/data-explorer/media/web-sync/sync-on-status.png differ diff --git a/data-explorer/media/web-sync/sync-on.png b/data-explorer/media/web-sync/sync-on.png new file mode 100644 index 0000000000..4886c17ed2 Binary files /dev/null and b/data-explorer/media/web-sync/sync-on.png differ diff --git a/data-explorer/toc.yml b/data-explorer/toc.yml index 1a463ee8aa..b9cc82c003 100644 --- a/data-explorer/toc.yml +++ b/data-explorer/toc.yml @@ -304,6 +304,8 @@ items: href: add-query-visualization.md - name: Customize settings in the web UI href: web-customize-settings.md + - name: Access the web UI anywhere + href: web-sync.md - name: Explore the sample gallery href: web-ui-samples-query.md - name: Explore the results grid diff --git a/data-explorer/web-customize-settings.md b/data-explorer/web-customize-settings.md index 541371566a..bfac7d0244 100644 --- a/data-explorer/web-customize-settings.md +++ b/data-explorer/web-customize-settings.md @@ -1,13 +1,13 @@ --- title: 'Customize settings in the Azure Data Explorer web UI' -description: In this guide, you'll learn how to customize your settings in the Azure Data Explorer web UI. +description: In this guide, you learn how to customize your settings in the Azure Data Explorer web UI. ms.topic: how-to -ms.date: 01/14/2025 +ms.date: 05/13/2025 --- # Customize settings in the Azure Data Explorer web UI -This article will guide you through the process of customizing settings in the [Azure Data Explorer web UI](https://dataexplorer.azure.com/home). You'll learn how to export and import environment settings, highlight error levels, and change datetime to specific time zone. This can help you protect your work environment and relocate it to other browsers and devices, as well as make it easier to identify errors. +This article guides you through the process of customizing settings in the [Azure Data Explorer web UI](https://dataexplorer.azure.com/home). You learn how to export and import environment settings, highlight error levels, and change datetime to specific time zone. It can help you protect your work environment and relocate it to other browsers and devices, as well as make it easier to identify errors. ## Prerequisites @@ -22,7 +22,7 @@ Select the settings icon :::image type="icon" source="media/web-customize-settin ## Set query recommendations -The query editor provides suggestions and warnings as you write your queries. The suggestions and warnings may be related to performance, correctness, or general best practices. To customize your suggestions and warnings, do the following steps: +The query editor provides suggestions and warnings as you write your queries. The suggestions and warnings might be related to performance, correctness, or general best practices. To customize your suggestions and warnings, do the following steps: 1. In the **Settings** > **Editing** window, select **Set query recommendations**. @@ -48,18 +48,21 @@ To learn how to set timeout limits outside of the web UI, see [Set timeout limit ## Export and import environment settings -The export and import actions help you protect your work environment and relocate it to other browsers and devices. The export action will export all your settings, cluster connections, and query tabs to a JSON file that can be imported into a different browser or device. +The export and import actions help you protect your work environment and relocate it to other browsers and devices. The export action exports all your settings, cluster connections, and query tabs to a JSON file that can be imported into a different browser or device. + +> [!NOTE] +> To sync your profile data to the cloud, see [Access your Azure Data Explorer web UI data anywhere](web-sync.md). Once enabled, exporting, and importing is no longer available. ### Export environment settings 1. In the **Settings** > **General** window, select **Export**. -1. The **adx-export.json** file will be downloaded to your local storage. +1. The **adx-export.json** file is downloaded to your local storage. 1. Select **Clear local state** to revert your environment to its original state. This setting deletes all your cluster connections and closes open tabs. > [!NOTE] -> **Export** only exports query related data. No dashboard data will be exported within the **adx-export.json** file. +> **Export** only exports query related data. No dashboard data is exported within the **adx-export.json** file. ### Import environment settings @@ -75,14 +78,14 @@ The export and import actions help you protect your work environment and relocat ## Highlight error levels -Azure Data Explorer tries to interpret the severity or verbosity level of each row in the results panel and color them accordingly. It does this by matching the distinct values of each column with a set of known patterns ("Warning", "Error", and so on). +Azure Data Explorer tries to interpret the severity or verbosity level of each row in the results panel and color them accordingly. It does so by matching the distinct values of each column with a set of known patterns (Warning, Error, and so on). ### Turn on error level highlighting To turn on error level highlighting: 1. Select the **Settings** icon next to your user name. -1. Select the **Appearance** tab and toggle the **Enable error level highlighting** option to the right. +1. Select the **Appearance** tab and toggle the **Enable error level highlighting** option. :::image type="content" source="media/web-customize-settings/enable-error-level-highlighting.png" alt-text="Screenshot showing how to enable error-level highlighting in the settings."::: @@ -96,7 +99,7 @@ For highlighted error levels, the column must be of [data type](/kusto/query/sca * If the column is of type `long` or `int`: * The column name must be *Level* - * Values may only include numbers between 1 and 5. + * Values can only include numbers between 1 and 5. * If the column is of type `string`: * The column name can optionally be *Level* to improve performance. * The column can only include the following values: @@ -117,10 +120,10 @@ Under **Settings** > **Share Dashboards Across Tenants**, toggle to **On**. :::image type="content" source="media/web-customize-settings/dashboard-sharing.png" alt-text="Screenshot of enabling dashboard sharing in settings."::: > [!IMPORTANT] -> If a tenant admin enables cross-tenant sharing and later disables cross-tenant sharing, all dashboards shared while the feature was active will remain accessible. - +> If a tenant admin enables cross-tenant sharing and later disables cross-tenant sharing, all dashboards shared while the feature was active remain accessible. ## Related content +* [Access your Azure Data Explorer web UI data anywhere](web-sync.md) * [Query data in the web UI](web-ui-query-overview.md) * [Visualize data with Azure Data Explorer dashboards](azure-data-explorer-dashboards.md) diff --git a/data-explorer/web-sync.md b/data-explorer/web-sync.md new file mode 100644 index 0000000000..8757d8faf5 --- /dev/null +++ b/data-explorer/web-sync.md @@ -0,0 +1,56 @@ +--- +title: Access your Azure Data Explorer web UI data anywhere +description: This guide teaches you how to access your Azure Data Explorer Web UI Data from anywhere using syncing. +ms.topic: how-to +ms.date: 05/13/2025 +#customer-intent: As a user, I want to learn how to sync my Azure Data Explorer web UI data so that I can access it from anywhere. +--- + +# Access your Azure Data Explorer web UI data anywhere + +This article describes how to sync your Azure Data Explorer web UI profile to the cloud, enabling a consistent experience across devices and browsers. When you sync, your browser's settings, tabs, and connections are stored in the cloud, making them accessible through the [Azure Data Explorer web UI](https://dataexplorer.azure.com/home) from anywhere. Synced data is now associated with your account rather than the specific machine, enabling a consistent experience across devices. + +## Prerequisites + +* A Microsoft account or a Microsoft Entra user identity. An Azure subscription isn't required. + +## Considerations + +Before enabling sync, consider the following points: + +* The first browser where syncing is enabled becomes the primary data source, overriding data in other browsers. +* Data is account-specific and can't be shared across different user accounts on the same machine. +* Syncing uploads your current device's data to the cloud, replacing local data on other browsers or devices with the cloud-stored version. +* Synced data is stored in your tenant's region. If no Azure region exists in the tenant's region, data is stored in an Azure region in Europe. +* Syncing is irreversible; once enabled: + * Data is no longer stored exclusively on your device + * [Exporting and importing](web-customize-settings.md#export-and-import-environment-settings) of your work environment under settings is no longer available + +## Sync user profile + +To sync your profile data, follow these steps: + +1. From the tab bar, select **Sync off**. + +1. From the **Sync user profile to cloud** dialog box, select **Turn sync on**. + + :::image type="content" source="media/web-sync/sync-on.png" alt-text="Screenshot of the Sync user profile to cloud dialog box with the Turn-on sync button highlighted."::: + +1. In the **Turn on sync to cloud** dialog box, select **Confirm**. + + >[!CAUTION] + > Syncing your profile to the cloud is irreversible. Once you confirm, your data is stored in the cloud and no longer on your device. + + :::image type="content" source="media/web-sync/sync-on-confirmation.png" alt-text="Screenshot of the Turn-on sync to cloud dialog box with the Confirm button highlighted."::: + +1. In the tab bar, verify that the status shows **Sync on**. Additionally, ensure that the **Sync on** status shows on other browsers or devices when signed into the same account. + + :::image type="content" source="media/web-sync/sync-on-status.png" alt-text="Screenshot of the tab bar with the Sync on status highlighted."::: + + >[!NOTE] + > If the status doesn't display as expected, ensure that you're logged into the same account used for syncing. + +## Related content + +* [Azure Data Explorer web UI query overview](web-ui-query-overview.md) +* [Customize settings in the Azure Data Explorer web UI](web-customize-settings.md)