Skip to content

Commit ad5a5a3

Browse files
committed
Adding link to new article in other places
1 parent 80af476 commit ad5a5a3

File tree

3 files changed

+16
-8
lines changed

3 files changed

+16
-8
lines changed

articles/cosmos-db/create-alerts.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: StefArroyo
55
ms.author: esarroyo
66
ms.service: cosmos-db
77
ms.topic: how-to
8-
ms.date: 07/16/2020
8+
ms.date: 02/08/2022
99
---
1010

1111
# Create alerts for Azure Cosmos DB using Azure Monitor
@@ -19,14 +19,19 @@ You can receive an alert based on the metrics, activity log events, or Log Analy
1919

2020
* **Activity log events** – This alert triggers when a certain event occurs. For example, when the keys of your Azure Cosmos account are accessed or refreshed.
2121

22-
* **Log Analytics** – This alert triggers when the value of a specified property in the results of a Log Analytics query crosses a threshold you assign. For example, you can write a Log Analytics query to monitor if the storage for a logical partition key is reaching the 20 GB logical partition key storage limit in Azure Cosmos DB.
22+
* **Log Analytics** – This alert triggers when the value of a specified property in the results of a Log Analytics query crosses a threshold you assign. For example, you can write a Log Analytics query to [monitor if the storage for a logical partition key is reaching the 20 GB logical partition key storage limit](how-to-alert-on-logical-partition-key-storage-size.md) in Azure Cosmos DB.
2323

2424
You can set up alerts from the Azure Cosmos DB pane or the Azure Monitor service in the Azure portal. Both the interfaces offer the same options. This article shows you how to set up alerts for Azure Cosmos DB using Azure Monitor.
2525

2626
## Create an alert rule
2727

2828
This section shows how to create an alert when you receive an HTTP status code 429, which is received when the requests are rate limited. For examples, you may want to receive an alert when there are 100 or more rate limited requests. This article shows you how to configure an alert for such scenario by using the HTTP status code. You can use the similar steps to configure other types of alerts as well, you just need to choose a different condition based on your requirement.
2929

30+
> [!TIP]
31+
> The scenario of alerting based on number of 429s exceeding a threshold is used here for illustration purposes. It does not mean that there is anything inherently wrong with seeing 429s on your database or container. In general, if you see 1-5% of requests with 429s in a production workload and your overall application latency is within your requirements, this is a normal and healthy sign that you are fully using the throughput (RU/s) you've provisioned. [Learn more about how to interpret and debug 429 exceptions](sql/troubleshoot-request-rate-too-large.md).
32+
33+
[Diagnose and troubleshoot Azure Cosmos DB request rate too large (429) exceptions]
34+
3035
1. Sign into the [Azure portal.](https://portal.azure.com/)
3136

3237
1. Select **Monitor** from the left-hand navigation bar and select **Alerts**.

articles/cosmos-db/how-to-alert-on-logical-partition-key-storage-size.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: deborahc
55
ms.author: dech
66
ms.service: cosmos-db
77
ms.topic: how-to
8-
ms.date: 01/28/2022
8+
ms.date: 02/08/2022
99
---
1010

1111
# Create alerts to monitor if storage for a logical partition key is approaching 20 GB
@@ -143,19 +143,20 @@ When the alert is fired, it will include:
143143
- Storage in KB of the logical partition key
144144
- Utilization of the 20 GB limit
145145
146-
For example, in the alert that was fired below, we see the logical partition of "ContosoTenant" has reached .78 of the 20GB logical partition storage limit, with 16GB of data in a particular database and collection.
146+
For example, in the alert that was fired below, we see the logical partition of "ContosoTenant" has reached 0.78 of the 20GB logical partition storage limit, with 16GB of data in a particular database and collection.
147147
148148
:::image type="content" source="media/how-to-alert-on-logical-partition-key-storage-size/alert-when-logical-partition-key-exceeds-threshold.png" alt-text="Example alert fired when logical partition key size exceeds threshold":::
149149
150150
## Remediation steps
151-
When the 20 GB logical partition size limit is reached, you won't be able to write any more data to that logical partition. As a result, it's recommended to re-architect your application with a different partition key as a long-term solution.
151+
When the 20 GB logical partition size limit is reached, you won't be able to write any more data to that logical partition. As a result, it's recommended to rearchitect your application with a different partition key as a long-term solution.
152152
153-
To help give time for this, you can request a temporary increase in the logical partition key limit for your existing application. [File an Azure support ticket](create-support-request-quota-increase.md) and select quota type **Temporary increase in container's logical partition key size.** Note this is intended as a temporary mitigation and not recommended as a long-term solution, as SLA guarantees are not honored when the limit is increased. To remove the configuration, file a support ticket and select quota type **Restore container’s logical partition key size to default (20 GB)**. This can be done after you have either deleted data to fit the 20 GB logical partition limit or have re-architected your application with a different partition key.
153+
To help give time for this, you can request a temporary increase in the logical partition key limit for your existing application. [File an Azure support ticket](create-support-request-quota-increase.md) and select quota type **Temporary increase in container's logical partition key size.** Note this is intended as a temporary mitigation and not recommended as a long-term solution, as SLA guarantees are not honored when the limit is increased. To remove the configuration, file a support ticket and select quota type **Restore container’s logical partition key size to default (20 GB)**. This can be done after you have either deleted data to fit the 20 GB logical partition limit or have rearchitected your application with a different partition key.
154154
155155
To learn about best practices for managing workloads that have partition keys requiring higher limits for storage or throughput, see [Create a synthetic partition key](synthetic-partition-keys.md).
156156
157157
## Next steps
158158
* How to [create alerts for Azure Cosmos DB using Azure Monitor](create-alerts.md).
159159
* How to [monitor normalized RU/s metric](monitor-normalized-request-units.md) in Azure Cosmos container.
160160
* How to [monitor throughput or request unit usage](monitor-request-unit-usage.md) of an operation in Azure Cosmos DB.
161+
* How to [interpret and debut 429 exceptions](sql/troubleshoot-request-rate-too-large.md) in Azure Cosmos container.
161162

articles/cosmos-db/partitioning-overview.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: deborahc
55
ms.author: dech
66
ms.service: cosmos-db
77
ms.topic: conceptual
8-
ms.date: 08/26/2021
8+
ms.date: 02/08/2022
99

1010
---
1111

@@ -26,7 +26,9 @@ A logical partition consists of a set of items that have the same partition key.
2626

2727
A logical partition also defines the scope of database transactions. You can update items within a logical partition by using a [transaction with snapshot isolation](database-transactions-optimistic-concurrency.md). When new items are added to a container, new logical partitions are transparently created by the system. You don't have to worry about deleting a logical partition when the underlying data is deleted.
2828

29-
There is no limit to the number of logical partitions in your container. Each logical partition can store up to 20GB of data. Good partition key choices have a wide range of possible values. For example, in a container where all items contain a `foodGroup` property, the data within the `Beef Products` logical partition can grow up to 20 GB. [Selecting a partition key](#choose-partitionkey) with a wide range of possible values ensures that the container is able to scale.
29+
There is no limit to the number of logical partitions in your container. Each logical partition can store up to 20GB of data. Good partition key choices have a wide range of possible values. For example, in a container where all items contain a `foodGroup` property, the data within the `Beef Products` logical partition can grow up to 20 GB. [Selecting a partition key](#choose-partitionkey) with a wide range of possible values ensures that the container is able to scale.
30+
31+
You can use Azure Monitor Alerts to [monitor if a logical partition's size is approaching 20 GB](how-to-alert-on-logical-partition-key-storage-size.md).
3032

3133
## Physical partitions
3234

0 commit comments

Comments
 (0)