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.

Introduction

Before diving into the experience, you should understand how it presents and visualizes information.

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.

• 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.

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 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.

1. Sign in to the Azure portal.

2. Search for Monitor and select Monitor.

   

3. Select Azure Cosmos DB.

   

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.

• Azure Cosmos DB - You can select all, a subset, or single Azure Cosmos DB resource.

• Time Range - by default, displays the last 4 hours of information based on the corresponding selections made.

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.

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:

Selecting the Azure Cosmos DB resource name highlighted in blue will take you 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:

Code	Description
200 OK	One of the following REST operations were successful: - GET on a resource. - PUT on a resource. - POST on a resource. - 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.

For a full list of status codes, consult the Azure Cosmos DB HTTP status code article.

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.

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.

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.

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.

View from an Azure Cosmos DB resource

1. Search for or select any of your existing Azure Cosmos DB accounts.

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.

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.

Insights overview

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.

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.

Normalized RU Consumption (max): This graph provides the max percentage between 0-100% of Normalized RU Consumption units for the specified period.

Pin, export, and expand

You can pin any one of the metric sections to an Azure Dashboard by selecting the pushpin icon at the top right of the section.

To export your data into the Excel format, select the down arrow icon to the left of the pushpin icon.

To expand or collapse all drop-down views in the workbook, select the expand icon to the left of the export icon:

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.

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.

Troubleshooting

For troubleshooting guidance, refer to the dedicated workbook-based insights troubleshooting article.

Next steps

• Configure metric alerts and service health notifications 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.