Merge pull request #231106 from seesharprun/cosmos-monitor-queries

Cosmos DB | Update monitor logs query titles and copy edit

Author: prmerger-automator[bot]

articles/cosmos-db/monitor-logs-basic-queries.md

@@ -1,26 +1,27 @@
 ---
 title: Troubleshoot issues with diagnostics queries
 titleSuffix: Azure Cosmos DB
-description: Learn how to query diagnostics logs for troubleshooting data stored in Azure Cosmos DB
+description: Query diagnostics logs using the Kusto query language (KQL) to troubleshoot queries and operations in Azure Cosmos DB.
 author: StefArroyo
 services: cosmos-db
 ms.service: cosmos-db
 ms.custom: ignite-2022
-ms.topic: how-to
-ms.date: 05/12/2021
+ms.topic: reference
+ms.date: 03/16/2023
 ms.author: esarroyo 
 ---
 
 # Troubleshoot issues with diagnostics queries
+
 [!INCLUDE[NoSQL, MongoDB, Cassandra, Gremlin, Table](includes/appliesto-nosql-mongodb-cassandra-gremlin-table.md)]
 
-In this article, we'll cover how to write simple queries to help troubleshoot issues with your Azure Cosmos DB account using diagnostics logs sent to **AzureDiagnostics (legacy)** and **Resource-specific (preview)** tables.
+In this article, we cover how to write simple queries to help troubleshoot issues with your Azure Cosmos DB account using diagnostics logs sent to **AzureDiagnostics (legacy)** and **Resource-specific (preview)** tables.
 
-For Azure Diagnostics tables, all data is written into one single table and users will need to specify which category they'd like to query.
+For Azure Diagnostics tables, all data is written into one single table and users need to specify which category they'd like to query.
 
 For resource-specific tables, data is written into individual tables for each category of the resource (not available for table API). We recommend this mode since it makes it much easier to work with the data, provides better discoverability of the schemas, and improves performance across both ingestion latency and query times.
 
-## <a id="azure-diagnostics-queries"></a> AzureDiagnostics Queries
+## Azure diagnostics queries
 
 - How to query for the operations that are taking longer than 3 milliseconds to run:
 
@@ -47,8 +48,8 @@ For resource-specific tables, data is written into individual tables for each ca
    | summarize count() by bin(TimeGenerated, 5s)
    | render timechart
    ```
-    
-- How to get partition key statistics to evaluate skew across top 3 partitions for a database account:
+
+- How to get partition key statistics to evaluate skew across top three partitions for a database account:
 
    ```Kusto
    AzureDiagnostics 
@@ -119,7 +120,7 @@ For resource-specific tables, data is written into individual tables for each ca
    ```
 
 - What is the maximum throughput that a partition has consumed?
-   
+
    ```kusto
    AzureDiagnostics
    | where ResourceProvider=="MICROSOFT.DOCUMENTDB" and Category=="DataPlaneRequests"
@@ -162,27 +163,26 @@ For resource-specific tables, data is written into individual tables for each ca
    | where todouble(sizeKb_d) > 800000
    ```
 
-- How to get P99 or P50 replication latencies for operations, request charge or the length of the response?
+- How to get P99 or P50 latencies for operations, request charge or the length of the response?
 
    ```kusto
    AzureDiagnostics
    | where ResourceProvider=="MICROSOFT.DOCUMENTDB" and Category=="DataPlaneRequests"
    | where TimeGenerated >= ago(2d)
    | summarize percentile(todouble(responseLength_s), 50), percentile(todouble(responseLength_s), 99), max(responseLength_s), percentile(todouble(requestCharge_s), 50), percentile(todouble(requestCharge_s), 99), max(requestCharge_s), percentile(todouble(duration_s), 50), percentile(todouble(duration_s), 99), max(duration_s), count() by OperationName, requestResourceType_s, userAgent_s, collectionRid_s, bin(TimeGenerated, 1h)
    ```
- 
+
 - How to get ControlPlane logs?
- 
+
    Remember to switch on the flag as described in the [Disable key-based metadata write access](audit-control-plane-logs.md#disable-key-based-metadata-write-access) article, and execute the operations by using Azure PowerShell, the Azure CLI, or Azure Resource Manager.
- 
+
    ```kusto  
    AzureDiagnostics 
    | where Category =="ControlPlaneRequests"
    | summarize by OperationName 
    ```
 
-
-## <a id="resource-specific-queries"></a> Resource-specific Queries
+## Resource-specific queries
 
 - How to query for the operations that are taking longer than 3 milliseconds to run:
 
@@ -207,8 +207,8 @@ For resource-specific tables, data is written into individual tables for each ca
     | summarize count() by bin(TimeGenerated, 5s)
     | render timechart
    ```
-    
-- How to get partition key statistics to evaluate skew across top 3 partitions for a database account:
+
+- How to get partition key statistics to evaluate skew across top three partitions for a database account:
 
    ```kusto
     CDBPartitionKeyStatistics
@@ -292,7 +292,7 @@ For resource-specific tables, data is written into individual tables for each ca
    | where parse_json(PartitionKey)[0] == "2" 
    ```
 
-- How to get the top partition keys with most RU/s consumed in a specific period? 
+- How to get the top partition keys with most RU/s consumed in a specific period?
 
    ```kusto
    CDBPartitionKeyRUConsumption
@@ -306,26 +306,26 @@ For resource-specific tables, data is written into individual tables for each ca
    ```kusto
    CDBPartitionKeyStatistics
    | where todouble(SizeKb) > 800000
-   ``` 
+   ```
 
-- How to get P99 or P50 replication latencies for operations, request charge or the length of the response?
+- How to get P99 or P50 latencies for operations, request charge or the length of the response?
 
    ```kusto
    CDBDataPlaneRequests
    | where TimeGenerated >= ago(2d)
    | summarize percentile(todouble(ResponseLength), 50), percentile(todouble(ResponseLength), 99), max(ResponseLength), percentile(todouble(RequestCharge), 50), percentile(todouble(RequestCharge), 99), max(RequestCharge), percentile(todouble(DurationMs), 50), percentile(todouble(DurationMs), 99), max(DurationMs),count() by OperationName, RequestResourceType, UserAgent, CollectionName, bin(TimeGenerated, 1h)
    ```
- 
+
 - How to get ControlPlane logs?
- 
+
    Remember to switch on the flag as described in the [Disable key-based metadata write access](audit-control-plane-logs.md#disable-key-based-metadata-write-access) article, and execute the operations by using Azure PowerShell, the Azure CLI, or Azure Resource Manager.
- 
+
    ```kusto  
    CDBControlPlaneRequests
    | summarize by OperationName 
    ```
 
-## Next steps 
-* For more information on how to create diagnostic settings for Azure Cosmos DB see [Creating Diagnostics settings](monitor-resource-logs.md) article.
+## Next steps
 
-* For detailed information about how to create a diagnostic setting by using the Azure portal, CLI, or PowerShell, see [create diagnostic setting to collect platform logs and metrics in Azure](../azure-monitor/essentials/diagnostic-settings.md) article.
+- For more information on how to create diagnostic settings for Azure Cosmos DB, see [Creating Diagnostics settings](monitor-resource-logs.md).
+- For detailed information about how to create a diagnostic setting by using the Azure portal, CLI, or PowerShell, see [create diagnostic setting to collect platform logs and metrics in Azure](../azure-monitor/essentials/diagnostic-settings.md).