Merge pull request #211116 from WilliamDAssafMSFT/20220913-sql-data-warehouse-monitor-workload-portal

20220913 bug fix, doc refresh

Author: v-regandowner

articles/synapse-analytics/sql-data-warehouse/media/sql-data-warehouse-monitor-workload-portal/enable_diagnostic_logs.png

@@ -1,14 +1,13 @@
 ---
-title: Monitor workload - Azure portal 
+title: Monitor workload - Azure portal
 description: Monitor Synapse SQL using the Azure portal
 author: WilliamDAssafMSFT
-manager: craigg
-ms.service: synapse-analytics
-ms.topic: conceptual
-ms.subservice: sql-dw 
-ms.date: 02/04/2020
 ms.author: wiassaf
 ms.reviewer: sngun
+ms.date: 09/13/2022
+ms.service: synapse-analytics
+ms.subservice: sql-dw
+ms.topic: conceptual
 ---
 
 # Monitor workload - Azure portal
@@ -22,15 +21,13 @@ This article describes how to use the Azure portal to monitor your workload. Thi
 
 ## Create a Log Analytics workspace
 
-Navigate to the browse blade for Log Analytics workspaces and create a workspace
+In the Azure portal, navigate to the page for Log Analytics workspaces, or use the Azure services search window to create a new Log Analytics workspace. 
 
-![Log Analytics workspaces](./media/sql-data-warehouse-monitor-workload-portal/log_analytics_workspaces.png)
+:::image type="content" source="./media/sql-data-warehouse-monitor-workload-portal/add_analytics_workspace.png" alt-text="Screenshot shows the Log Analytics workspaces where you can select Add.":::
 
-![Screenshot shows the Log Analytics workspaces where you can select Add.](./media/sql-data-warehouse-monitor-workload-portal/add_analytics_workspace.png)
+:::image type="content" source="./media/sql-data-warehouse-monitor-workload-portal/add_analytics_workspace_2.png" alt-text="Screenshot shows the Log Analytics workspace where you can enter values.":::
 
-![Screenshot shows the Log Analytics workspace where you can enter values.](./media/sql-data-warehouse-monitor-workload-portal/add_analytics_workspace_2.png)
-
-For more details on workspaces, visit the following [documentation](../../azure-monitor/logs/quick-create-workspace.md?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.jsond#create-a-workspace).
+For more information on workspaces, see [Create a Log Analytics workspace](../../azure-monitor/logs/quick-create-workspace.md).
 
 ## Turn on Resource logs
 
@@ -42,29 +39,33 @@ Configure diagnostic settings to emit logs from your SQL pool. Logs consist of t
 - [sys.dm_pdw_waits](/sql/relational-databases/system-dynamic-management-views/sys-dm-pdw-waits-transact-sql?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json&view=azure-sqldw-latest&preserve-view=true)
 - [sys.dm_pdw_sql_requests](/sql/relational-databases/system-dynamic-management-views/sys-dm-pdw-sql-requests-transact-sql?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json&view=azure-sqldw-latest&preserve-view=true)
 
-![Enabling resource logs](./media/sql-data-warehouse-monitor-workload-portal/enable_diagnostic_logs.png)
+:::image type="content" source="./media/sql-data-warehouse-monitor-workload-portal/enable_diagnostic_logs.png" alt-text="Screenshot of the page to create a diagnostic setting in the Azure portal.":::
+
+Logs can be emitted to Azure Storage, Stream Analytics, or Log Analytics. For this tutorial, select Log Analytics. Select all desired categories and metrics and choose **Send to Log Analytics workspace**. 
 
-Logs can be emitted to Azure Storage, Stream Analytics, or Log Analytics. For this tutorial, select Log Analytics.
+:::image type="content" source="./media/sql-data-warehouse-monitor-workload-portal/specify_logs.png" alt-text="Screenshot of the page to specify which logs to collect in the Azure portal.":::
 
-![Specify logs](./media/sql-data-warehouse-monitor-workload-portal/specify_logs.png)
+Select **Save** to create the new diagnostic setting. It may take a few minutes for data to appear in queries.
 
 ## Run queries against Log Analytics
 
-Navigate to your Log Analytics workspace where you can do the following:
+Navigate to your Log Analytics workspace where you can:
 
 - Analyze logs using log queries and save queries for reuse
 - Save queries for reuse
 - Create log alerts
 - Pin query results to a dashboard
 
-For details on the capabilities of log queries, visit the following [documentation](/azure/data-explorer/kusto/query/?bc=%2fazure%2fsynapse-analytics%2fsql-data-warehouse%2fbreadcrumb%2ftoc.json&toc=%2fazure%2fsynapse-analytics%2fsql-data-warehouse%2ftoc.json).
+For details on the capabilities of log queries using Kusto, see [Kusto Query Language (KQL) overview](/azure/data-explorer/kusto/query/).
 
-![Log Analytics workspace editor](./media/sql-data-warehouse-monitor-workload-portal/log_analytics_workspace_editor.png)
+:::image type="content" source="./media/sql-data-warehouse-monitor-workload-portal/log_analytics_workspace_editor.png" alt-text="Log Analytics workspace editor.":::
 
-![Log Analytics workspace queries](./media/sql-data-warehouse-monitor-workload-portal/log_analytics_workspace_queries.png)
+:::image type="content" source="./media/sql-data-warehouse-monitor-workload-portal/log_analytics_workspace_queries.png" alt-text="Log Analytics workspace queries.":::
 
 ## Sample log queries
 
+Set the [scope of your queries](../../azure-monitor/logs/scope.md) to the Log Analytics workspace resource.
+
 ```Kusto
 //List all queries
 AzureDiagnostics
@@ -85,10 +86,10 @@ AzureDiagnostics
 //Count of all queued queries
 AzureDiagnostics
 | where Category contains "waits"
-| where Type_s == "UserConcurrencyResourceType"
+| where Type == "UserConcurrencyResourceType"
 | summarize totalQueuedQueries = dcount(RequestId_s)
 ```
 
 ## Next steps
 
-Now that you have set up and configured Azure monitor logs, [customize Azure dashboards](../../azure-portal/azure-portal-dashboards.md?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json) to share across your team.
+- Now that you have set up and configured Azure monitor logs, [customize Azure dashboards](../../azure-portal/azure-portal-dashboards.md?toc=/azure/synapse-analytics/sql-data-warehouse/toc.json&bc=/azure/synapse-analytics/sql-data-warehouse/breadcrumb/toc.json) to share across your team.