Merge pull request #226740 from paulth1/insights-overview

[AQ] edit pass: insights-overview

Author: ShawnJackson

articles/cosmos-db/insights-overview.md

@@ -1,166 +1,167 @@
 ---
 title: Monitor Azure Cosmos DB with Azure Monitor Azure Cosmos DB insights| Microsoft Docs
 description: This article describes the Azure Cosmos DB insights feature of Azure Monitor that provides Azure Cosmos DB owners with a quick understanding of performance and utilization issues with their Azure Cosmos DB accounts.
-author: SnehaGunda
-ms.author: sngun
+author: seesharprun
+ms.author: sidandrews
 ms.topic: conceptual
 ms.service: cosmos-db
-ms.date: 05/11/2020
-ms.reviewer: shijain
+ms.date: 02/08/2023
+ms.reviewer: markjbrown
 ms.custom: subject-monitoring, ignite-2022
 ---
 
 # Explore Azure Monitor Azure Cosmos DB insights
 
-Azure Cosmos DB insights provides a view of the overall performance, failures, capacity, and operational health of all your Azure Cosmos DB resources in a unified interactive experience. This article will help you understand the benefits of this new monitoring experience, and how you can modify and adapt the experience to fit the unique needs of your organization.   
+Azure Cosmos DB insights provides a view of the overall performance, failures, capacity, and operational health of all your Azure Cosmos DB resources in a unified interactive experience. This article helps you understand the benefits of this new monitoring experience, and how you can modify and adapt the experience to fit the unique needs of your organization.
 
 ## Introduction
 
-Before diving into the experience, you should understand how it presents and visualizes information. 
+Before you begin, you should understand how information is presented and visualized.
 
 It delivers:
 
-* **At scale perspective** of your Azure Cosmos DB resources across all your subscriptions in a single location, with the ability to selectively scope to only those subscriptions and resources you are interested in evaluating.
+* **At-scale perspective** of your Azure Cosmos DB resources across all your subscriptions in a single location. You can selectively scope to only the subscriptions and resources that you're interested in evaluating.
+* **Drill-down analysis** of a particular Azure Cosmos DB resource. You can diagnose issues or perform detailed analysis by using the categories of utilization, failures, capacity, and operations. Selecting any one of the options provides an in-depth view of the relevant Azure Cosmos DB metrics.
+* **Customizable** experience built on top of Azure Monitor workbook templates. You can change what metrics are displayed, modify or set thresholds that align with your limits, and then save into a custom workbook. Charts in the workbooks can then be pinned to Azure dashboards.
 
-* **Drill down analysis** of a particular Azure Cosmos DB resource to help diagnose issues or perform detailed analysis by category - utilization, failures, capacity, and operations. Selecting any one of those options provides an in-depth view of the relevant Azure Cosmos DB metrics.  
-
-* **Customizable** - This experience is built on top of Azure Monitor workbook templates allowing you to change what metrics are displayed, modify or set thresholds that align with your limits, and then save into a custom workbook. Charts in the workbooks can then be pinned to Azure dashboards.  
-
-This feature does not require you to enable or configure anything, these Azure Cosmos DB metrics are collected by default.
+This feature doesn't require you to enable or configure anything. These Azure Cosmos DB metrics are collected by default.
 
 >[!NOTE]
->There is no charge to access this feature and you will only be charged for the Azure Monitor essential features you configure or enable, as described on the [Azure Monitor pricing details](https://azure.microsoft.com/pricing/details/monitor/) page.
+>There's no charge to access this feature. You'll only be charged for the Azure Monitor essential features you configure or enable, as described on the [Azure Monitor pricing details](https://azure.microsoft.com/pricing/details/monitor/) page.
 
 ## View utilization and performance metrics for Azure Cosmos DB
 
-To view the utilization and performance of your storage accounts across all of your subscriptions, perform the following steps.
+To view the utilization and performance of your storage accounts across all your subscriptions:
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 
-2. Search for **Monitor** and select **Monitor**.
+1. Search for **Monitor** and select **Monitor**.
 
-    ![Search box with the word "Monitor" and a dropdown that says Services "Monitor" with a speedometer style image](./media/insights-overview/search-monitor.png)
+    ![Screenshot that shows the Search box with the word "Monitor" and a dropdown that says Services "Monitor" with a speedometer-style image.](./media/insights-overview/search-monitor.png)
 
-3. Select **Azure Cosmos DB**.
+1. Select **Azure Cosmos DB**.
 
-    ![Screenshot of Azure Cosmos DB overview workbook](./media/insights-overview/cosmos-db.png)
+    ![Screenshot that shows the Azure Cosmos DB Overview workbook.](./media/insights-overview/cosmos-db.png)
 
 ### Overview
 
-On **Overview**, the table displays interactive Azure Cosmos DB metrics. You can filter the results based on the options you select from the following drop-down lists:
-
-* **Subscriptions** - only subscriptions that have an Azure Cosmos DB resource are listed.  
+On the **Overview** page, the table displays interactive Azure Cosmos DB metrics. You can filter the results based on the options you select from the following dropdown lists:
 
-* **Azure Cosmos DB** - You can select all, a subset, or single Azure Cosmos DB resource.
+* **Subscriptions**: Only subscriptions that have an Azure Cosmos DB resource are listed.
+* **Azure Cosmos DB**: You can select all, a subset, or a single Azure Cosmos DB resource.
+* **Time Range**: By default, the last four hours of information are displayed based on the corresponding selections made.
 
-* **Time Range** - by default, displays the last 4 hours of information based on the corresponding selections made.
+The counter tile under the dropdown lists rolls up the total number of Azure Cosmos DB resources that are in the selected subscriptions. Conditional color-coding or heatmaps for columns in the workbook report transaction metrics. The deepest color has the highest value. A lighter color is based on the lowest values.
 
-The counter tile under the drop-down lists rolls-up the total number of Azure Cosmos DB resources are in the selected subscriptions. There is conditional color-coding or heatmaps for columns in the workbook that report transaction metrics. The deepest color has the highest value and a lighter color is based on the lowest values. 
+Select a dropdown arrow next to one of the Azure Cosmos DB resources to reveal a breakdown of the performance metrics at the individual database container level.
 
-Selecting a drop-down arrow next to one of the Azure Cosmos DB resources will reveal a breakdown of the performance metrics at the individual database container level:
+![Screenshot that shows the Expanded dropdown that reveals individual database containers and associated performance breakdown.](./media/insights-overview/container-view.png)
 
-![Expanded drop down revealing individual database containers and associated performance breakdown](./media/insights-overview/container-view.png)
-
-Selecting the Azure Cosmos DB resource name highlighted in blue will take you to the default **Overview** for the associated Azure Cosmos DB account. 
+Select the Azure Cosmos DB resource name highlighted in blue to go to the default **Overview** for the associated Azure Cosmos DB account.
 
 ### Failures
 
-Select **Failures** at the top of the page and the **Failures** portion of the workbook template opens. It shows you  total requests with the distribution of responses that make up those requests:
+Select the **Failures** tab to open the **Failures** portion of the workbook template. It shows you the total requests with the distribution of responses that make up those requests:
 
-![Screenshot of failures with breakdown by HTTP request type](./media/insights-overview/failures.png)
+![Screenshot that shows failures with breakdown by HTTP request type.](./media/insights-overview/failures.png)
 
 | Code |  Description       | 
 |-----------|:--------------------|
 | `200 OK`	| One of the following REST operations were successful: </br>- GET on a resource. </br> - PUT on a resource. </br> - POST on a resource. </br> - POST on a stored procedure resource to execute the stored procedure.|
 | `201 Created` | A POST operation to create a resource is successful. |
-| `404 Not Found` | The operation is attempting to act on a resource that no longer exists. For example, the resource may have already been deleted. |
+| `404 Not Found` | The operation is attempting to act on a resource that no longer exists. For example, the resource might have already been deleted. |
 
-For a full list of status codes, consult the [Azure Cosmos DB HTTP status code article](/rest/api/cosmos-db/http-status-codes-for-cosmosdb).
+For a full list of status codes, see [HTTP status codes for Azure Cosmos DB](/rest/api/cosmos-db/http-status-codes-for-cosmosdb).
 
 ### Capacity
 
-Select **Capacity** at the top of the page and the **Capacity** portion of the workbook template opens. It shows you how many documents you have, your document growth over time, data usage, and the total amount of available storage that you have left.  This can be used to help identify potential storage and data utilization issues.
+Select the **Capacity** tab to open the **Capacity** portion of the workbook template. It shows you:
+- How many documents you have. 
+- Your document growth over time.
+- Data usage.
+- Total amount of available storage that you have left.
+
+This information helps you to identify potential storage and data utilization issues.
 
-![Capacity workbook](./media/insights-overview/capacity.png) 
+![Screenshot that shows the Capacity workbook.](./media/insights-overview/capacity.png)
 
-As with the overview workbook, selecting the drop-down next to an Azure Cosmos DB resource in the **Subscription** column will reveal a breakdown by the individual containers that make up the database.
+As with the Overview workbook, selecting the dropdown next to an Azure Cosmos DB resource in the **Subscription** column reveals a breakdown by the individual containers that make up the database.
 
 ### Operations
 
-Select **Operations** at the top of the page and the **Operations** portion of the workbook template opens. It gives you the ability to see your requests broken down by the type of requests made.
+Select the **Operations** tab to open the **Operations** portion of the workbook template. You can see your requests broken down by the type of requests made.
 
-So in the example below you see that `eastus-billingint` is predominantly receiving read requests, but with a small number of upsert and create requests. Whereas `westeurope-billingint` is read-only from a request perspective, at least over the past four hours that the workbook is currently scoped to via its time range parameter.
+In the following example, you see that `eastus-billingint` is predominantly receiving read requests, but with a few upsert and create requests. You can also see that `westeurope-billingint` is read-only from a request perspective, at least over the past four hours that the workbook is currently scoped to via its time range parameter.
 
-![Operations workbook](./media/insights-overview/operation.png)
+![Screenshot that shows the Operations workbook.](./media/insights-overview/operation.png)
 
 ## View from an Azure Cosmos DB resource
 
 1. Search for or select any of your existing Azure Cosmos DB accounts.
 
-:::image type="content" source="./media/insights-overview/cosmosdb-search.png" alt-text="Search for Azure Cosmos DB." border="true":::
+   :::image type="content" source="./media/insights-overview/cosmosdb-search.png" alt-text="Screenshot that shows searching for Azure Cosmos DB." border="true":::
 
-2. Once you've navigated to your Azure Cosmos DB account, in the Monitoring section select **Insights (preview)** or **Workbooks** to perform further analysis on throughput, requests, storage, availability, latency, system, and account management.
+1. After you've moved to your Azure Cosmos DB account, in the **Monitoring** section, select **Insights (preview)** or **Workbooks**. Now you can perform further analysis on throughput, requests, storage, availability, latency, system, and account management.
 
-:::image type="content" source="./media/insights-overview/cosmosdb-overview.png" alt-text="Azure Cosmos DB Insights Overview." border="true":::
+   :::image type="content" source="./media/insights-overview/cosmosdb-overview.png" alt-text="Screenshot that shows the Azure Cosmos DB Insights Overview page." border="true":::
 
 ### Time range
 
-By default, the **Time Range** field displays data from the **Last 24 hours**. You can modify the time range to display data anywhere from the last 5 minutes to the last seven days. The time range selector also includes a **Custom** mode that allows you to type in the start/end dates to view a custom time frame based on available data for the selected account.
+By default, the **Time Range** field displays data from the last 24 hours. You can modify the time range to display data anywhere from the last 5 minutes to the last 7 days. The time range selector also includes a **Custom** mode. Enter the start/end dates to view a custom time frame based on available data for the selected account.
 
-:::image type="content" source="./media/insights-overview/cosmosdb-time-range.png" alt-text="Azure Cosmos DB Time Range." border="true":::
+:::image type="content" source="./media/insights-overview/cosmosdb-time-range.png" alt-text="Screenshot that shows the Azure Cosmos DB Time Range." border="true":::
 
 ### Insights overview
 
-The **Overview** tab provides the most common metrics for the selected Azure Cosmos DB account including:
+The **Overview** tab provides the most common metrics for the selected Azure Cosmos DB account, including:
 
 * Total Requests
 * Failed Requests (429s)
 * Normalized RU Consumption (max)
 * Data & Index Usage
 * Azure Cosmos DB Account Metrics by Collection
 
-**Total Requests:** This graph provides a view of the total requests for the account broken down by status code. The units at the bottom of the graph are a sum of the total requests for the period.
+**Total Requests**: This graph provides a view of the total requests for the account broken down by status code. The units at the bottom of the graph are a sum of the total requests for the period.
 
-:::image type="content" source="./media/insights-overview/cosmosdb-total-requests.png" alt-text="Azure Cosmos DB Total Requests Graph." border="true":::
+:::image type="content" source="./media/insights-overview/cosmosdb-total-requests.png" alt-text="Screenshot that shows the Azure Cosmos DB Total Requests graph." border="true":::
 
 **Failed Requests (429s)**: This graph provides a view of failed requests with a status code of 429. The units at the bottom of the graph are a sum of the total failed requests for the period.
 
-:::image type="content" source="./media/insights-overview/cosmosdb-429.png" alt-text="Azure Cosmos DB Failed Requests Graph." border="true":::
+:::image type="content" source="./media/insights-overview/cosmosdb-429.png" alt-text="Screenshot that shows the Azure Cosmos DB Failed Requests graph." border="true":::
 
-**Normalized RU Consumption (max)**: This graph provides the max percentage between 0-100% of Normalized RU Consumption units for the specified period.
+**Normalized RU Consumption (max)**: This graph provides the maximum percentage between 0% and 100% of Normalized RU Consumption units for the specified period.
 
-:::image type="content" source="./media/insights-overview/cosmosdb-normalized-ru.png" alt-text="Azure Cosmos DB Normalized RU Consumption." border="true":::
+:::image type="content" source="./media/insights-overview/cosmosdb-normalized-ru.png" alt-text="Screenshot that shows the Azure Cosmos DB Normalized RU Consumption graph." border="true":::
 
 ## Pin, export, and expand
 
-You can pin any one of the metric sections to an [Azure Dashboard](../azure-portal/azure-portal-dashboards.md) by selecting the pushpin icon at the top right of the section.
+You can pin any one of the metric sections to an [Azure dashboard](../azure-portal/azure-portal-dashboards.md) by selecting the pushpin in the upper-right corner of the section.
 
-![Metric section pin to dashboard example](./media/insights-overview/pin.png)
+![Screenshot that shows the metric section pin to dashboard example.](./media/insights-overview/pin.png)
 
-To export your data into the Excel format, select the down arrow icon to the left of the pushpin icon.
+To export your data into the Excel format, select the down arrow to the left of the pushpin.
 
-![Export workbook icon](./media/insights-overview/export.png)
+![Screenshot that shows the Export workbook down arrow.](./media/insights-overview/export.png)
 
-To expand or collapse all drop-down views in the workbook, select the expand icon to the left of the export icon:
+To expand or collapse all dropdown views in the workbook, select the expand arrow to the left of the down arrow.
 
-![Expand workbook icon](./media/insights-overview/expand.png)
+![Screenshot that shows the Expand workbook arrow.](./media/insights-overview/expand.png)
 
 ## Customize Azure Cosmos DB insights
 
-Since this experience is built on top of Azure Monitor workbook templates, you have the ability to **Customize** > **Edit** and **Save** a copy of your modified version into a custom workbook. 
+This experience is built on top of Azure Monitor workbook templates. You can use **Customize** > **Edit** > **Save** to modify and save a copy of your modified version into a custom workbook.
 
-![Customize bar](./media/insights-overview/customize.png)
+![Screenshot that shows the Customize button.](./media/insights-overview/customize.png)
 
-Workbooks are saved within a resource group, either in the **My Reports** section that's private to you or in the **Shared Reports** section that's accessible to everyone with access to the resource group. After you save the custom workbook, you need to go to the workbook gallery to launch it.
+Workbooks are saved within a resource group. The **My Reports** section is private to you. The **Shared Reports** section is accessible to everyone with access to the resource group. After you save the custom workbook, you must go to the workbook gallery to start it.
 
-![Launch workbook gallery from command bar](./media/insights-overview/gallery.png)
+![Screenshot that shows the Gallery button.](./media/insights-overview/gallery.png)
 
 ## Troubleshooting
 
-For troubleshooting guidance, refer to the dedicated workbook-based insights [troubleshooting article](../azure-monitor/insights/troubleshoot-workbooks.md).
+For troubleshooting guidance, see [Troubleshooting workbook-based insights](../azure-monitor/insights/troubleshoot-workbooks.md).
 
 ## Next steps
 
-* Configure [metric alerts](../azure-monitor/alerts/alerts-metric.md) and [service health notifications](../service-health/alerts-activity-log-service-notifications-portal.md) to set up automated alerting to aid in detecting issues.
-
-* Learn the scenarios workbooks are designed to support, how to author new and customize existing reports, and more by reviewing [Create interactive reports with Azure Monitor workbooks](../azure-monitor/visualize/workbooks-overview.md).
+* Configure [metric alerts](../azure-monitor/alerts/alerts-metric.md) and [Service Health notifications](../service-health/alerts-activity-log-service-notifications-portal.md) to set up automated alerting to aid in detecting issues.
+* For more information on how the scenario workbooks are designed and how to author new and customize existing reports, see [Create interactive reports with Azure Monitor workbooks](../azure-monitor/visualize/workbooks-overview.md).