Merge pull request #50073 from kevinvngo/patch-43

Updated TOC and created concept article for monitoring

Author: ktoliver

articles/sql-data-warehouse/TOC.yml

@@ -141,16 +141,16 @@
       href: memory-and-concurrency-limits.md
   - name: Manageability & monitoring
     items:
-    - name: Query Activity & Resource Utilization  
-      href: sql-data-warehouse-manage-monitor.md
+    - name: Scale, pause, resume
+      href: sql-data-warehouse-manage-compute-overview.md
+    - name: Resource utilization & query activity 
+      href: sql-data-warehouse-concept-resource-utilization-query-activity.md 
     - name: Data protection
       href: backup-and-restore.md
-    - name: Scale-out, pause, resume
-      href: sql-data-warehouse-manage-compute-overview.md
-    - name: Maintenance schedule
-      href: service-maintenance.md
     - name: Recommendations 
       href: sql-data-warehouse-concept-recommendations.md
+    - name: Maintenance schedule
+      href: service-maintenance.md
     - name: Troubleshoot
       href: sql-data-warehouse-troubleshoot.md
   - name: Integration
@@ -211,13 +211,15 @@
       href: analyze-your-workload.md    
   - name: Monitor and tune
     items:
+    - name: Monitor your workload
+      href: sql-data-warehouse-manage-monitor.md
     - name: Restore - Portal
       href: sql-data-warehouse-restore-database-portal.md
     - name: Restore - PowerShell
       href: sql-data-warehouse-restore-database-powershell.md
     - name: Restore - REST API
       href: sql-data-warehouse-restore-database-rest-api.md
-    - name: Upgrade to Gen2
+    - name: Upgrade your Gen1 data warehouse
       href: upgrade-to-latest-generation.md
     - name: Automate performance levels
       href: manage-compute-with-azure-functions.md

articles/sql-data-warehouse/sql-data-warehouse-concept-resource-utilization-query-activity.md

@@ -0,0 +1,50 @@
+---
+title: Azure SQL Data Warehouse manageability and monitoring - query activity, resource utilization | Microsoft Docs
+description: Learn what capabilities are available to manage and monitor Azure SQL Data Warehouse. Use the Azure portal and Dynamic Management Views (DMVs) to understand query activity and resource utilization of your data warehouse.
+services: sql-data-warehouse
+author: kevinvngo
+manager: craigg-msft
+ms.service: sql-data-warehouse
+ms.topic: conceptual
+ms.component: manage
+ms.date: 08/26/2018
+ms.author: kevin
+ms.reviewer: igorstan
+---
+
+# Monitoring resource utilization and query activity in Azure SQL Data Warehouse
+Azure SQL Data Warehouse provides a rich monitoring experience within the Azure portal to surface insights to your data warehouse workload. The Azure portal is the recommended tool when monitoring your data warehouse as it provides configurable retentions periods, alerts, recommendations, and customizable charts and dashboards for metrics and logs. The portal also enables you to integrate with other Azure monitoring services such as Operations Management Suite (OMS)/Log Analytics and Azure Monitor to provide a holistic monitoring experience for not only your data warehouse but also your entire Azure analytics platform for an integrated monitoring experience. This documentation describes what monitoring capabilities are available to optimize and manage your analytics platform with SQL Data Warehouse. 
+
+## Resource Utilization 
+The following metrics are available in the Azure portal.
+
+| Metric Name                           | Description     | Aggregation Type |
+| --------------------------------------- | ---------------- | --------------------------------------- |
+| CPU percentage                          | CPU utilization across all nodes for the data warehouse | Maximum      |
+| Data IO percentage                      | IO Utilization across all nodes for the data warehouse | Maximum   |
+| Successful Connections                  | Number of successful connections to the data | Total            |
+| Failed Connections                      | Number of failed connections to the data warehouse | Total            |
+| Blocked by Firewall                     | Number of logins to the data warehouse which was blocked | Total            |
+| DWU limit                              | Service level objective of the data warehouse | Maximum   |
+| DWU percentage                          | Maximum between CPU percentage and Data IO percentage | Maximum   |
+| DWU used                                | DWU limit * DWU percentage | Maximum   |
+| Cache hit percentage | (cache hits / cache miss) * 100  where cache hits is the sum of all columnstore segments hits in the local SSD cache and cache miss is the columnstore segments misses in the local SSD cache summed across all nodes | Maximum |
+| Cache used percentage | (cache used / cache capacity) * 100 where cache used is the sum of all bytes in the local SSD cache across all nodes and cache capacity is the sum of the storage capacity of the local SSD cache across all nodes | Maximum |
+
+## Query Activity
+For a programmatic experience when monitoring SQL Data Warehouse via T-SQL, the service provides a set of Dynamic Management Views (DMVs). These views are useful when actively troubleshooting and identifying performance bottlenecks with your workload.
+
+To view the list of DMVs that SQL Data Warehouse provides, refer to this [documentation](https://docs.microsoft.com/azure/sql-data-warehouse/sql-data-warehouse-reference-tsql-system-views#sql-data-warehouse-dynamic-management-views-dmvs). 
+
+## Metrics and diagnostics logging
+Both metrics and logs can be exported to [Operations Management Suite](https://azure.microsoft.com/resources/videos/operations-management-suite-oms-overview/) (OMS), specifically the [Log analytics](https://docs.microsoft.com/azure/log-analytics/log-analytics-overview) component and can be programmatically accessed through [Log Search](https://docs.microsoft.com/azure/log-analytics/log-analytics-tutorial-viewdata).
+
+
+> [!NOTE]
+> As of August 2018, logs are currently being implemented for SQL Data Warehouse
+
+## Next steps
+The following How-to guides describe common scenarios and use cases when monitoring and managing your data warehouse:
+
+- [Monitor your data warehouse workload with DMVs](https://docs.microsoft.com/azure/sql-data-warehouse/sql-data-warehouse-manage-monitor)
+