AWS amazondynamodb documentation change
Summary
Completely restructured throttling documentation with new explanations, diagrams, and diagnostic workflows
Security assessment
The changes improve clarity about throttling mechanics and troubleshooting but focus on performance/cost management rather than security. No evidence of addressing security vulnerabilities.
Diff
diff --git a/amazondynamodb/latest/developerguide/TroubleshootingThrottling.md b/amazondynamodb/latest/developerguide/TroubleshootingThrottling.md index bdf9e8ba9..63984d440 100644 --- a//amazondynamodb/latest/developerguide/TroubleshootingThrottling.md +++ b//amazondynamodb/latest/developerguide/TroubleshootingThrottling.md @@ -5 +5 @@ -# Throttling issues for DynamoDB +# Troubleshooting throttling in Amazon DynamoDB @@ -7 +7,30 @@ -Throttling prevents your application from consuming too many capacity units. This topic discusses how to troubleshoot common throttling issues for provisioned and on-demand capacity modes. This topic also describes how to use CloudWatch to investigate where the issues might be coming from. +DynamoDB implements throttling for two primary purposes: maintaining overall service performance and cost control. Throttling either serves as an intentional safeguard that prevents performance degradation when consumption rates exceed capacity or as a cost control mechanism when you reach maximum throughput or service quota limits. When throttling occurs, DynamoDB returns specific exceptions with detailed information about why the request was throttled and which resource was impacted. Each reason for throttling corresponds to specific CloudWatch metrics that provide additional insights into the frequency and patterns of throttling events. + +The following diagram illustrates the four primary scenarios where DynamoDB implements protective throttling: + + 1. **Key range throughput exceeded (in both modes)** : + +Consumption directed at specific partitions exceeds the [internal partition-level throughput limits](./bp-partition-key-design.html). + + 2. **Provisioned throughput exceeded (in provisioned mode)** : + +Consumption exceeds the [ provisioned capacity units](./provisioned-capacity-mode.html) (read or write) configured for a table or a global secondary index (GSI). + + 3. **Account-level service quotas exceeded (in on-demand mode)** : + +Consumption causes a table or GSI to exceed the [ per-table account-level service quotas ](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ServiceQuotas.html#default-limits-throughput) for read/write throughput in the current AWS Region. These quotas serve as backstop safeguards and can be increased. + + 4. **On-demand maximum throughput exceeded (in on-demand mode)** : + +Consumption exceeds the configured [maximum throughput limits](./on-demand-capacity-mode-max-throughput.html) set for a table or GSI. These are limits you configure specifically for cost control purposes. + + + + + + +This guide is organized to help you understand and work with throttling in DynamoDB. First, we help you identify the specific type of throttling affecting your workload through a [diagnostic framework](./throttling-diagnosing-workflow.html). + +Then, the [resolution guide](./troubleshooting-throttling-diagnostics.html) section offers specific guidance for each throttling scenario, including CloudWatch metrics to monitor for detection and analysis, and recommended steps for optimization. By following this structured approach, you can better diagnose the root cause of throttling and implement the appropriate solution to ensure your DynamoDB tables operate efficiently. + +To get started, follow [Diagnosing throttling](./throttling-diagnosing-workflow.html) to learn how to identify which type of throttling is affecting your workload and implement the recommended resolution strategy. @@ -11 +40,3 @@ Throttling prevents your application from consuming too many capacity units. Thi - * [Troubleshooting throttling issues for provisioned mode](./TroubleshootingThrottling-common-issues.html) + * [Diagnosing throttling](./throttling-diagnosing-workflow.html) + + * [DynamoDB throttling resolution guide](./troubleshooting-throttling-diagnostics.html) @@ -13 +44 @@ Throttling prevents your application from consuming too many capacity units. Thi - * [Troubleshooting throttling issues for on-demand mode](./TroubleshootingThrottlingOnDemand.html) + * [Understanding Global Secondary Index (GSI) write throttling and back pressure in DynamoDB](./gsi-throttling.html) @@ -15 +46 @@ Throttling prevents your application from consuming too many capacity units. Thi - * [Using CloudWatch metrics to investigate throttling issues](./TroubleshootingThrottling-cloudwatch.html) + * [CloudWatch throttling metrics](./TroubleshootingThrottling-cloudwatch.html) @@ -28 +59 @@ Latency -Provisioned mode +Diagnosing throttling