Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added data-explorer/media/web-sync/sync-on-status.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added data-explorer/media/web-sync/sync-on.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 2 additions & 0 deletions data-explorer/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
27 changes: 15 additions & 12 deletions data-explorer/web-customize-settings.md
Original file line number Diff line number Diff line change
@@ -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

Expand All @@ -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**.

Expand All @@ -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

Expand All @@ -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.":::

Expand All @@ -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:
Expand All @@ -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)
56 changes: 56 additions & 0 deletions data-explorer/web-sync.md
Original file line number Diff line number Diff line change
@@ -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)