Skip to content

Commit c74c97f

Browse files
Merge pull request #2733 from MicrosoftDocs/main638936569372154088sync_temp
For protected branch, push strategy should use PR and merge to target branch method to work around git push error
2 parents 33805b9 + 9dfa260 commit c74c97f

27 files changed

+246
-243
lines changed

data-explorer/kusto/docs-navigation.md

Lines changed: 13 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -2,38 +2,37 @@
22
title: KQL docs navigation guide
33
description: Learn how to understand which version of KQL documentation you are viewing and how to switch to a different version.
44
ms.topic: conceptual
5-
ms.date: 08/14/2024
5+
ms.date: 09/15/2025
66
---
77
# KQL docs navigation guide
88

99
> [!INCLUDE [applies](includes/applies-to-version/applies.md)] [!INCLUDE [fabric](includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](includes/applies-to-version/azure-data-explorer.md)] [!INCLUDE [monitor](includes/applies-to-version/monitor.md)] [!INCLUDE [sentinel](includes/applies-to-version/sentinel.md)]
1010
11-
12-
The behavior of KQL may vary when using this language in different services. When you view any KQL documentation article by using our Learn website, the currently chosen service name is visible above the table of contents (TOC) under the **Version** dropdown. Switch between services using the version dropdown to see the KQL behavior for the selected service.
11+
KQL behavior can vary across services. On Microsoft Learn, the selected service name appears above the table of contents (TOC) under the **Version** dropdown. To view behavior for another service, use the **Version** dropdown to switch services.
1312

1413
## Change service selection
1514

16-
If you want to see the documentation for a different version of KQL, select the expander arrow located at the end of the current version moniker. Then select any service you want. When you select a different service, the displayed documentation suddenly changes to show the differences for the newly chosen version. There might or might not be any changes, and both cases are common.
15+
To view documentation for another KQL version, select the expander arrow at the end of the current version moniker, then select a service. The page updates to show any differences for that version. Some services have no differences, so the content might not change.
1716

18-
:::image type="content" source="media/docs-navigation/version.gif" alt-text="Screen capture of selecting a different version in the TOC.":::
17+
:::image type="content" source="media/docs-navigation/version.gif" alt-text="Screenshot of selecting a different KQL version from the table of contents.":::
1918

20-
## HTTPS parameter view=
19+
## HTTPS view= parameter
2120

22-
Each article whose web address begins with `https://learn.microsoft.com/kusto/` has a parameter named `?view=` appended to its address. This parameter value is the versioning moniker code.
21+
Articles at `https://learn.microsoft.com/kusto/` include a `?view=` parameter. The parameter value is the versioning moniker code.
2322

24-
The moniker code in the https address always matches the moniker name that is displayed in the versioning control.
23+
The moniker code in the HTTPS address always matches the moniker name displayed in the versioning control.
2524

2625
## Applies to services
2726

28-
Most of the KQL articles have the words **Applies to** under their title. On the same line, there follows a handy listing of services with indicators of which services are relevant for this article. For example, a certain function could be applicable to Fabric and Azure Data Explorer, but not Azure Monitor or others. If you do not see the service you are using, most likely the article is not relevant to your service.
27+
Most KQL articles include **Applies to** under the title. The line lists services and shows which ones the article applies to. For example, a function might apply to Microsoft Fabric and Azure Data Explorer, but not to Azure Monitor. If you don't see your service, the article likely doesn't apply.
2928

3029
## Versions
3130

32-
The following table describes the different versions of KQL and the services they are associated with.
31+
This table describes KQL versions and their associated services.
3332

3433
| Version | Description |
3534
|---|---|
36-
| Microsoft Fabric | [Microsoft Fabric](/fabric/get-started/microsoft-fabric-overview) is an end-to-end analytics and data platform designed for enterprises that require a unified solution. It encompasses data movement, processing, ingestion, transformation, real-time event routing, and report building. Within the suite of experiences offered in Microsof Fabric, [Real-Time Intelligence](/fabric/real-time-intelligence/overview) is a powerful service that empowers everyone in your organization to extract insights and visualize their data in motion. It offers an end-to-end solution for event-driven scenarios, streaming data, and data logs. <br> <br> The main query environment for KQL in Microsoft Fabric is the [KQL queryset](/fabric/real-time-intelligence/kusto-query-set). <br> <br> KQL in Microsoft Fabric supports query operators, functions, and management commands. |
37-
| Azure Data Explorer | [Azure Data Explorer](/azure/data-explorer/data-explorer-overview) is a fully managed, high-performance, big data analytics platform that makes it easy to analyze high volumes of data in near real time. There are several [query environments and integrations](/azure/data-explorer/integrate-query-overview) that can be used in Azure Data Explorer, including the [web UI](/azure/data-explorer/web-ui-query-overview). <br> <br> KQL in Azure Data Explorer is the full, native version, which supports all query operators, functions, and management commands.|
38-
| Azure Monitor | [Log Analytics](/azure/azure-monitor/logs/log-analytics-overview) is a tool in the Azure portal that's used to edit and run log queries against data in the [Azure Monitor](/azure/azure-monitor/overview) Logs store. You interact with Log Anlytics in a [Log Analytics workspace in the Azure portal](/azure/azure-monitor/logs/log-analytics-overview#log-analytics-interface). <br> <br> KQL in Azure Monitor uses a subset of the overall KQL operators and functions. |
39-
| Microsoft Sentinel | [Microsoft Sentinel](/azure/sentinel/overview) is a scalable, cloud-native security information and event management (SIEM) that delivers an intelligent and comprehensive solution for SIEM and security orchestration, automation, and response (SOAR). Microsoft Sentinel provides cyberthreat detection, investigation, response, and proactive hunting, with a bird's-eye view across your enterprise. Microsoft Sentinel is built on top of the Azure Monitor service and it uses Azure Monitor's Log Analytics workspaces to store all of its data. <br> <br> KQL in Microsoft Sentinel uses a subset of the overall KQL operators and functions. |
35+
| Microsoft Fabric | [Microsoft Fabric](/fabric/get-started/microsoft-fabric-overview) is an end-to-end analytics and data platform for enterprises that need a unified solution. It covers data movement, processing, ingestion, transformation, real-time event routing, and report building. Within the suite of experiences in Microsoft Fabric, [Real-Time Intelligence](/fabric/real-time-intelligence/overview) lets everyone in your organization extract insights and visualize streaming data. It provides an end-to-end solution for event-driven scenarios, streaming data, and data logs. <br> <br> The main query environment for KQL in Microsoft Fabric is the [KQL queryset](/fabric/real-time-intelligence/kusto-query-set). <br> <br> KQL in Microsoft Fabric supports query operators, functions, and management commands. |
36+
| Azure Data Explorer | [Azure Data Explorer](/azure/data-explorer/data-explorer-overview) is a fully managed, high-performance analytics platform for near real-time analysis of large data volumes. Use several [query environments and integrations](/azure/data-explorer/integrate-query-overview), including the [web UI](/azure/data-explorer/web-ui-query-overview). <br> <br> KQL in Azure Data Explorer is the full native version. It supports all query operators, functions, and management commands.|
37+
| Azure Monitor | [Log Analytics](/azure/azure-monitor/logs/log-analytics-overview) is a tool in the Azure portal you use to edit and run log queries against data in the [Azure Monitor](/azure/azure-monitor/overview) Logs store. Use Log Analytics in a [Log Analytics workspace in the Azure portal](/azure/azure-monitor/logs/log-analytics-overview#log-analytics-interface). <br> <br> KQL in Azure Monitor uses a subset of KQL operators and functions. |
38+
| Microsoft Sentinel | [Microsoft Sentinel](/azure/sentinel/overview) is a scalable, cloud-native security information and event management (SIEM) platform with security orchestration, automation, and response (SOAR). It provides threat detection, investigation, response, and proactive hunting across your enterprise. It uses Azure Monitor Log Analytics workspaces to store its data. <br> <br> KQL in Microsoft Sentinel uses a subset of KQL operators and functions. |

data-explorer/kusto/index.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ metadata:
1010
ms.topic: landing-page
1111
author: spelluru
1212
ms.author: spelluru
13-
ms.date: 08/11/2024
13+
ms.date: 09/15/2025
1414

1515
# linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | sample | tutorial | video | whats-new
1616

-14.5 KB
Loading
-110 KB
Loading

data-explorer/kusto/query/kql-learning-resources.md

Lines changed: 15 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,44 +1,45 @@
11
---
2-
title: Kusto Query Language learning resources
3-
description: This article provides a list of various learning resources to help you ramp up on Kusto Query Language (KQL) effectively.
2+
title: Kusto Query Language Learning Resources
3+
description: Learn KQL from scratch with curated resources, including tutorials, demos, and training programs for data analysts and professionals.
44
ms.reviewer: alexans
55
ms.topic: concept-article
6-
ms.date: 08/11/2024
6+
ms.date: 09/15/2025
77
#customerIntent: As a data analyst, I want to access various learning resources for Kusto Query Language (KQL), so that I can effectively explore and analyze data using KQL.
88
---
9+
910
# Kusto Query Language learning resources
1011

1112
> [!INCLUDE [applies](../includes/applies-to-version/applies.md)] [!INCLUDE [fabric](../includes/applies-to-version/fabric.md)] [!INCLUDE [azure-data-explorer](../includes/applies-to-version/azure-data-explorer.md)] [!INCLUDE [monitor](../includes/applies-to-version/monitor.md)] [!INCLUDE [sentinel](../includes/applies-to-version/sentinel.md)]
1213
13-
Kusto Query Language (KQL) is a powerful tool to explore your data and discover patterns, identify anomalies and outliers, create statistical modeling, and more. Are you new to KQL or want to improve your KQL skills? Take a look at the following learning resources.
14+
Use Kusto Query Language (KQL) to explore your data, discover patterns, identify anomalies and outliers, build statistical models, and more. New to KQL or want to improve your skills? Use the following learning resources.
1415

15-
For more information on KQL, see [KQL overview](index.md).
16+
For more information, see [KQL overview](index.md).
1617

17-
::: moniker range="microsoft-sentinel || azure-monitor"
18+
:::moniker range="microsoft-sentinel || azure-monitor"
1819

1920
## Demo environment
2021

21-
You can practice Kusto Query Language statements in a [Log Analytics demo environment](https://aka.ms/lademo) in the Azure portal. There's no charge to use this practice environment, but you do need an Azure account to access it.
22+
Practice Kusto Query Language statements in the [Log Analytics demo environment](https://aka.ms/lademo) in the Azure portal. It's free, but you need an Azure account.
2223

23-
Like Log Analytics in your production environment, it can be used in many ways:
24+
Like your production Log Analytics workspace, the demo environment lets you:
2425

25-
* **Choose a table on which to build a query.** From the default **Tables** tab (shown in the red rectangle at the upper left), select a table from the list of tables grouped by topics (shown at the lower left). Expand the topics to see the individual tables, and you can further expand each table to see all its fields (columns). Double-clicking on a table or a field name places it at the point of the cursor in the query window. Type the rest of your query following the table name, as directed below.
26+
* **Choose a table on which to build a query.** From the **Tables** tab, select a table from the list grouped by topic. Expand a topic to see its tables. Expand a table to see its fields (columns). Double-click a table or field name to insert it at the cursor in the query window. Type the rest of the query after the table name.
2627

27-
* **Find an existing query to study or modify.** Select the **Queries** tab (shown in the red rectangle at the upper left) to see a list of queries available out-of-the-box. Or, select **Queries** from the button bar at the top right. Double-click a query to place it in the query window at the point of the cursor.
28+
* **Find an existing query to study or modify.** Select the **Queries** tab to see the list of queries available by default. Alternatively, select **Queries** from the button bar. Double-click a query to insert it at the cursor in the query window.
2829

2930
::: moniker-end
3031

3132
::: moniker range="microsoft-sentinel"
3233

33-
Like in this demo environment, you can query and filter data in the Microsoft Sentinel **Logs** page. You can select a table and drill down to see columns. You can modify the default columns shown using the **Column chooser**, and you can set the default time range for queries. If the time range is explicitly defined in the query, the time filter is unavailable (grayed out).
34+
As in the demo environment, query and filter data on the Microsoft Sentinel **Logs** page. Select a table and drill down to see its columns. Use the **Column chooser** to modify the default columns, and set the default time range for queries. If the time range is explicitly defined in the query, the time filter is unavailable (grayed out).
3435

35-
If Microsoft Sentinel is [onboarded to the Defender portal](/azure/sentinel/microsoft-sentinel-defender-portal), you can also query and filter data in the Microsoft Defender **Advanced hunting** page. For more information, see [Advanced hunting with Microsoft Sentinel data in Microsoft Defender portal](/defender-xdr/advanced-hunting-microsoft-defender?toc=%2Fazure%2Fsentinel%2FTOC.json&bc=%2Fazure%2Fsentinel%2Fbreadcrumb%2Ftoc.json&branch=main).
36+
If Microsoft Sentinel is [onboarded to the Defender portal](/azure/sentinel/microsoft-sentinel-defender-portal), query and filter data on the Microsoft Defender **Advanced hunting** page. For more information, see [Advanced hunting with Microsoft Sentinel data in Microsoft Defender portal](/defender-xdr/advanced-hunting-microsoft-defender?toc=%2Fazure%2Fsentinel%2FTOC.json&bc=%2Fazure%2Fsentinel%2Fbreadcrumb%2Ftoc.json&branch=main).
3637

3738
::: moniker-end
3839

39-
## General training
40+
## KQL training
4041

41-
For general information about KQL, see:
42+
Learn more about KQL:
4243

4344
* [Pluralsight: KQL from scratch](https://www.pluralsight.com/courses/kusto-query-language-kql-from-scratch)
4445
* [Kusto Detective Agency](https://detective.kusto.io/)

data-explorer/kusto/query/kql-quick-reference.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
2-
title: KQL quick reference
3-
description: A list of useful KQL functions and their definitions with syntax examples.
2+
title: KQL Quick Reference
3+
description: Learn how to use KQL functions like `where`, `summarize`, and `render` with syntax examples to streamline your data queries.
44
ms.reviewer:
55
ms.topic: conceptual
6-
ms.date: 08/11/2024
6+
ms.date: 09/15/2025
77
adobe-target: true
88
---
99

-30.5 KB
Loading
-4.37 KB
Loading
-12 KB
Loading
15.3 KB
Loading

0 commit comments

Comments
 (0)