Merge pull request #264709 from RoseHJM/mdb-add-logs

v-dirichards · web-flow · commit 9fc4420bb7ed · 2024-01-31T14:02:29.000-06:00
MDB - add new log information
diff --git a/articles/dev-box/.openpublishing.redirection.dev-box.json b/articles/dev-box/.openpublishing.redirection.dev-box.json
@@ -34,6 +34,16 @@
       "source_path_from_root": "/articles/dev-box/concept-common-components.md",
       "redirect_url": "/azure/dev-box/overview-what-is-microsoft-dev-box#components-shared-with-azure-deployment-environments",
       "redirect_document_id": false
-    }    
+    },
+    {
+      "source_path_from_root": "/articles/dev-box/how-to-configure-dev-box-azure-diagnostic-logs.md",
+      "redirect_url": "/azure/dev-box/monitor-dev-box",
+      "redirect_document_id": false
+    },    
+    {
+      "source_path_from_root": "/articles/dev-box/monitor-reference.md",
+      "redirect_url": "/azure/dev-box/monitor-dev-box-reference",
+      "redirect_document_id": false
+    }
   ]
 }
diff --git a/articles/dev-box/monitor-dev-box-reference.md b/articles/dev-box/monitor-dev-box-reference.md
@@ -1,22 +1,23 @@
 ---
-title: Dev center (DevCenter) diagnostic logs reference
+title: Monitoring Microsoft Dev Box data reference
 titleSuffix: Microsoft Dev Box
-description: Schema reference for dev center (DevCenter) diagnostic logs. Review the list of Azure Storage and Azure Monitor Logs properties included in monitoring data.
+description: Important reference material needed when you monitor Dev Box. Schema reference for dev center diagnostic logs. Review the included Azure Storage and Azure Monitor Logs properties.
 services: dev-box
 ms.service: dev-box
 ms.topic: reference
 author: delvissantos
 ms.author: delvissantos
-ms.date: 01/17/2024
+ms.custom: horz-monitor, subject-monitoring
+ms.date: 01/30/2023
 ---
 
-# Microsoft dev center monitoring data reference
+# Monitoring Microsoft Dev Box data reference
 
-This article provides a reference for log and metric data collected for a Microsoft Dev Box dev center. You can use the collected data to analyze the performance and availability of resources within your dev center. For details about how to collect and analyze monitoring data for your dev center, see [Configure Azure diagnostic logs for a dev center](how-to-configure-dev-box-azure-diagnostic-logs.md).
+This article provides a reference for log and metric data collected for a Microsoft Dev Box dev center. You can use the collected data to analyze the performance and availability of resources within your dev center. For details about how to collect and analyze monitoring data for your dev center, see [Monitoring Microsoft Dev Box](monitor-dev-box.md).
 
 ## Resource logs
 
-The following table lists the properties of resource logs in a dev center. The resource logs are collected into Azure Monitor Logs or Azure Storage. In Azure Monitor, logs are collected in the **DevCenterDiagnosticLogs** table under the resource provider name of `MICROSOFT.DEVCENTER`.
+The following table lists the properties of resource logs in a Microsoft Dev Box dev center. The resource logs are collected into Azure Monitor Logs or Azure Storage. In Azure Monitor, logs are collected in the **DevCenterDiagnosticLogs** table under the resource provider name of `MICROSOFT.DEVCENTER`.
 
 | Azure Storage field or property | Azure Monitor Logs property | Description |
 | --- | --- | --- |
@@ -37,5 +38,5 @@ A dev center uses Kusto tables from Azure Monitor Logs. You can query these tabl
 
 ## Related content
 
-- [Configure Azure diagnostic logs for a dev center](how-to-configure-dev-box-azure-diagnostic-logs.md)
+- [Monitor Dev Box](monitor-dev-box.md)
 - [Monitor Azure resources with Azure Monitor](../azure-monitor/essentials/monitor-azure-resource.md)
diff --git a/articles/dev-box/monitor-dev-box.md b/articles/dev-box/monitor-dev-box.md
@@ -1,16 +1,37 @@
 ---
-title: Configure Azure Diagnostic Logs
+title: Monitoring Microsoft Dev Box
 titleSuffix: Microsoft Dev Box
-description: Learn how to use Azure diagnostic logs to see an audit history for your dev center.
+description: Start here to learn how to monitor Dev Box. Learn how to use Azure diagnostic logs to see an audit history for your dev center.
 services: dev-box
 ms.service: dev-box
 ms.topic: how-to
 author: delvissantos
 ms.author: delvissantos
-ms.date: 04/28/2023
+ms.custom: horz-monitor, subject-monitoring
+ms.date: 01/30/2023
 ---
 
-# Configure Azure diagnostic logs for a dev center 
+# Monitoring Microsoft Dev Box
+
+When you have critical applications and business processes relying on Azure resources, you want to monitor those resources for their availability, performance, and operation. 
+
+This article describes the monitoring data generated by Microsoft Dev Box. Microsoft Dev Box uses [Azure Monitor](/azure/azure-monitor/overview). If you're unfamiliar with the features of Azure Monitor common to all Azure services that use it, read [Monitoring Azure resources with Azure Monitor](/azure/azure-monitor/essentials/monitor-azure-resource).
+
+## Monitoring data 
+
+Microsoft Dev Box collects the same kinds of monitoring data as other Azure resources that are described in [Monitoring data from Azure resources](/azure/azure-monitor/essentials/monitor-azure-resource#monitoring-data-from-Azure-resources). 
+
+See [Monitoring *Dev Box* data reference](monitor-dev-box-reference.md) for detailed information on the metrics and logs metrics created by Dev Box.
+
+## Collection and routing
+
+Platform metrics and the Activity log are collected and stored automatically, but can be routed to other locations by using a diagnostic setting.  
+
+Resource Logs aren't collected and stored until you create a diagnostic setting and route them to one or more locations.
+
+See [Create diagnostic setting to collect platform logs and metrics in Azure](/azure/azure-monitor/platform/diagnostic-settings) for the detailed process for creating a diagnostic setting using the Azure portal, CLI, or PowerShell. When you create a diagnostic setting, you specify which categories of logs to collect. The categories for *Dev box* are listed in [Microsoft Dev Box monitoring data reference](monitor-dev-box-reference.md#resource-logs).
+
+### Configure Azure diagnostic logs for a dev center 
 
 With Azure diagnostic logs for DevCenter, you can view audit logs for dataplane operations in your dev center. These logs can be routed to any of the following destinations:
 
@@ -26,11 +47,7 @@ Diagnostics logs allow you to export basic usage information from your dev cente
 
 To learn more about the different types of logs available for dev centers, see [DevCenter Diagnostic Logs Reference](monitor-reference.md).
 
-## Prerequisites
-
-A dev center.
-
-## Enable logging with the Azure portal
+### Enable logging with the Azure portal
 
 Follow these steps enable logging for your Azure DevCenter resource:
 
@@ -43,7 +60,7 @@ Follow these steps enable logging for your Azure DevCenter resource:
 4. Select **Add diagnostic setting** in the open page.
 
 
-### Enable logging with Azure Storage
+#### Enable logging with Azure Storage
 
 To use a storage account to store the logs, follow these steps:
 
@@ -60,7 +77,7 @@ To use a storage account to store the logs, follow these steps:
 
 3. Select **Save**.
 
-### Send to Log Analytics
+#### Send to Log Analytics
 
 To use Log Analytics for the logs, follow these steps:
 
@@ -75,13 +92,13 @@ To use Log Analytics for the logs, follow these steps:
 
 4. Select **Save**.
 
-## Enable logging with PowerShell
+### Enable logging with PowerShell
 
 The following example shows how to enable diagnostic logs via the Azure PowerShell Cmdlets.
 
 [!INCLUDE [updated-for-az](../../includes/updated-for-az.md)]
 
-### Enable diagnostic logs in a storage account
+#### Enable diagnostic logs in a storage account
 
 1. Sign in to Azure PowerShell:
 
@@ -102,7 +119,7 @@ The following example shows how to enable diagnostic logs via the Azure PowerShe
     New-AzDiagnosticSetting -Name $diagname -ResourceId $devcenterid -StorageAccountId $storageacctid -Log $log
     ```
 
-### Enable diagnostics logs for Log Analytics workspace
+#### Enable diagnostics logs for Log Analytics workspace
 
 1. Sign in to Azure PowerShell:
 
@@ -132,9 +149,10 @@ DevCenter stores data in the following tables.
 | Table | Description |
 |:---|:---|
 | DevCenterDiagnosticLogs | Table used to store dataplane request/response information on dev box or environments within the dev center.  |
+| DevCenterResourceOperationLogs | Operation logs pertaining to DevCenter resources, including information around resource health status changes. |
+| DevCenterBillingEventLogs | Billing event related to DevCenter resources. This log contains information about the quantity and unit charged per meter. |
 
-
-### Sample Kusto Queries
+## Sample Kusto Queries
 After enabling diagnostic settings on your dev center, you should be able to view audit logs for the tables within a log analytics workspace.
 
 Here are some queries that you can enter into Log search to help your monitor your dev boxes.
@@ -162,10 +180,9 @@ DevCenterDiagnosticLogs
 
 These examples are just a small sample of the rich queries that can be performed in Monitor using the Kusto Query Language. For more information, see [samples for Kusto queries](/azure/data-explorer/kusto/query/samples?pivots=azuremonitor).
 
-## Next steps
-
-To learn more about Azure logs, see the following articles:
+## Related content
 
-* [Azure Diagnostic logs](../azure-monitor/essentials/platform-logs-overview.md)
-* [Azure Monitor logs](../azure-monitor/logs/log-query-overview.md)
-* [Azure Log Analytics REST API](/rest/api/loganalytics)
+- [Monitor Dev Box](monitor-dev-box.md)
+- [Azure Diagnostic logs](../azure-monitor/essentials/platform-logs-overview.md)
+- [Azure Monitor logs](../azure-monitor/logs/log-query-overview.md)
+- [Azure Log Analytics REST API](/rest/api/loganalytics)
diff --git a/articles/dev-box/toc.yml b/articles/dev-box/toc.yml
@@ -38,12 +38,12 @@ items:
   - name: Manage a dev box pool
     href: how-to-manage-dev-box-pools.md
   - name: Limit number of dev boxes per project
-    href: tutorial-dev-box-limits.md  
-      
+    href: tutorial-dev-box-limits.md      
   - name: Configure Visual Studio caches
     href: how-to-generate-visual-studio-caches.md
-  - name: Configure Azure Diagnostic Logs
-    href: how-to-configure-dev-box-azure-diagnostic-logs.md    
+  - name: Monitor Dev Box
+    displayName: diagnostic, logs
+    href: monitor-dev-box.md    
 - name: Prepare images
   items:
   - name: Configure an Azure compute gallery
@@ -91,7 +91,8 @@ items:
     - name: REST API
       href: /rest/api/devcenter/
     - name: Monitoring Microsoft DevCenter data reference
-      href: monitor-reference.md  
+      displayName: diagnostic, logs
+      href: monitor-dev-box-reference.md  
 - name: Resources
   items: 
     - name: Azure roadmap
