Skip to content

Commit 2dffaed

Browse files
committed
hanges based on review
1 parent 193968a commit 2dffaed

15 files changed

+19
-19
lines changed

articles/cosmos-db/cassandra/cassandra-monitor-insights.md

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Monitor and debug with insights in Cassandra API
3-
description: Learn how to debug and monitor your Azure Cosmos DB Cassandra API account using Insights
2+
title: Monitor and debug with insights in Azure Cosmos DB Cassandra API
3+
description: Learn how to debug and monitor your Azure Cosmos DB Cassandra API account using insights
44
author: iriaosara
55
ms.author: iriaosara
66
ms.service: cosmos-db
@@ -10,7 +10,7 @@ ms.date: 05/02/2022
1010
ms.custom: template-how-to
1111
---
1212

13-
# Monitor and debug with insights in Cassandra API
13+
# Monitor and debug with insights in Azure Cosmos DB Cassandra API
1414
[!INCLUDE[appliesto-cassandra-api](../includes/appliesto-cassandra-api.md)]
1515

1616
Azure Cosmos DB helps provide insights into your application’s performance using the Azure Monitor API. Azure Monitor for Azure Cosmos DB provides metrics view to monitor your Cassandra API Account and create dashboards.
@@ -23,75 +23,75 @@ This article walks through some common use cases and how best to use Azure Cosm
2323
## Availability
2424
The availability shows the percentage of successful requests over the total requests per hour. Monitor service availability for a specified Cassandra API account.
2525

26-
:::image type="content" source="./media/cassandra-monitor-insights/service_availability_min.png" alt-text="service availability":::
26+
:::image type="content" source="./media/cassandra-monitor-insights/service-availability-min.png" alt-text=" Screenshot for service availability for an Azure Cosmos DB Cassandra API account.":::
2727

2828

2929
## Latency
3030
These charts below show the read and write latency observed by your Cassandra API account in the region where your account is operating. You can visualize latency across regions for a geo-replicated account. This metric doesn't represent the end-to-end request latency. Use diagnostic log for cases where you experience high latency for query operations.
3131

3232
The server side latency(Avg) by region also displays a sudden latency spike on the server. It can help a customer differentiate between a client side latency spike and a server-side latency spike.
3333

34-
:::image type="content" source="./media/cassandra-monitor-insights/avg_server_side_latency_by_region.png" alt-text="The average server side latency by region":::
34+
:::image type="content" source="./media/cassandra-monitor-insights/avg-server-side-latency-by-region.png" alt-text="Diagram showing the average server side latency by region.":::
3535

3636
Also view server-side latency by different operations in a specific keyspace.
3737

38-
:::image type="content" source="./media/cassandra-monitor-insights/avg_ss_latency_keyspace_operation.png" alt-text="The average server side latency for a specific keyspace based on operation":::
38+
:::image type="content" source="./media/cassandra-monitor-insights/avg-ss-latency-keyspace-operation.png" alt-text="Screenshot showing the average server side latency for a specific keyspace based on operation.":::
3939

4040

41-
:::image type="content" source="./media/cassandra-monitor-insights/avg_ss_latency_region_keyspace.png" alt-text="Average server side latency for a by region and keyspace":::
41+
:::image type="content" source="./media/cassandra-monitor-insights/avg-ss-latency-region-keyspace.png" alt-text="Screenshot showing the average server side latency for a by region and keyspace.":::
4242

4343

4444
Is your application experiencing any throttling? The chart below shows the total number of requests failed with a 429-response code.
4545
Exceeding provisioned throughput could be one of the reasons. Enable [Server Side Retry](./prevent-rate-limiting-errors.md) when your application experiences high throttling due to higher consumption of request units than what is allocated.
4646

47-
:::image type="content" source="./media/cassandra-monitor-insights/throttled_requests.png" alt-text="Graph showing throttled request with a defined time frame":::
47+
:::image type="content" source="./media/cassandra-monitor-insights/throttled-requests.png" alt-text="Screenshot of graph showing throttled request with a defined time frame.":::
4848

4949

5050

51-
## System and Management Operations
51+
## System and management operations
5252
The system view helps show metadata requests count by primary partition. It also helps identify throttled requests. The management operation shows the account activities such as creation, deletion, key, network and replication settings. Request volume per status code over a time period.
5353

54-
:::image type="content" source="./media/cassandra-monitor-insights/metadata_requests_status_code.png" alt-text="Request status code based on metadata":::
54+
:::image type="content" source="./media/cassandra-monitor-insights/metadata-requests-status-code.png" alt-text="Screenshot showing request status code based on metadata.":::
5555

5656
- Metric chart for account diagnostic, network and replication settings over a specified period and filtered based on a Keyspace.
5757

58-
:::image type="content" source="./media/cassandra-monitor-insights/diagnostic_network_replication.png" alt-text="Diagnostic network replication":::
58+
:::image type="content" source="./media/cassandra-monitor-insights/diagnostic-network-replication.png" alt-text="Screenshot of diagnostic network replication for a Cassandra API account.":::
5959

6060

6161
- Metric chart to view account key rotation.
6262

6363
You can view changes to primary or secondary password for your Cassandra API account.
6464

65-
:::image type="content" source="./media/cassandra-monitor-insights/cosmosdb_account_key.png" alt-text="Cosmos DB rotation key":::
65+
:::image type="content" source="./media/cassandra-monitor-insights/cosmos-db-account-key.png" alt-text="Screenshot showing Cosmos DB rotation key for a Cassandra API account.":::
6666

6767

6868
## Storage
6969
Storage distribution for raw and index storage. Also a count of documents in the Cassandra API account.
7070

71-
:::image type="content" source="./media/cassandra-monitor-insights/data_index_usage.png" alt-text="Document count within a Cassandra API account":::
71+
:::image type="content" source="./media/cassandra-monitor-insights/data-index-usage.png" alt-text="Diagram showing the document count within a Cassandra API account.":::
7272

7373
Maximum request units consumption for an account over a defined time period.
7474

75-
:::image type="content" source="./media/cassandra-monitor-insights/normalized_ru_consumption.png" alt-text="Maximum request unit consumption":::
75+
:::image type="content" source="./media/cassandra-monitor-insights/normalized-ru-consumption.png" alt-text="Diagram showing the maximum request unit consumption.":::
7676

7777

78-
## Throughput and Requests
78+
## Throughput and requests
7979
The Total Request Units metric displays the requests unit usage based on operation types.
8080

8181
These operations can be analyzed within a given time interval, defined keyspace or table.
8282

83-
:::image type="content" source="./media/cassandra-monitor-insights/total_cassandra_requests.png" alt-text="Screenshot image of a graph showing the total cassandra requests for an account":::
83+
:::image type="content" source="./media/cassandra-monitor-insights/total-cassandra-requests.png" alt-text="Screenshot image of a graph showing the total cassandra requests for an account.":::
8484

85-
:::image type="content" source="./media/cassandra-monitor-insights/total_request_units.png" alt-text="Screenshot image of a graph showing the total request units for a cassandra account":::
85+
:::image type="content" source="./media/cassandra-monitor-insights/total-request-units.png" alt-text="Screenshot image of a graph showing the total request units for a cassandra account.":::
8686

8787
The Normalized RU Consumption metric is a metric between 0% to 100% that is used to help measure the utilization of provisioned throughput on a database or container. The metric can also be used to view the utilization of individual partition key ranges on a database or container. One of the main factors of a scalable application is having a good cardinality of partition keys.
8888
The chart below shows if your application’s high RU consumption is because of hot partition.
8989

90-
:::image type="content" source="./media/cassandra-monitor-insights/normalized_ru_pk_rangeid.png" alt-text="{alt-text}":::
90+
:::image type="content" source="./media/cassandra-monitor-insights/normalized-ru-pk-rangeid.png" alt-text="Screenshot showing normalized request unit consumption by partition key range id.":::
9191

9292
The chart below shows a breakdown of requests by different status code. Understand the meaning of the different codes for you [Cassandra API codes](./error-codes-solution.md)
9393

94-
:::image type="content" source="./media/cassandra-monitor-insights/total_request_by_status_code.png" alt-text="Screenshot image of a graph showing the total request by status code for a cassandra api account":::
94+
:::image type="content" source="./media/cassandra-monitor-insights/total-request-by-status-code.png" alt-text="Screenshot image of a graph showing the total request by status code for a cassandra api account.":::
9595

9696

9797
## Next steps

0 commit comments

Comments
 (0)