本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# CloudWatch 限流度量指標
<a name="TroubleshootingThrottling-cloudwatch"></a>

本頁提供 CloudWatch 度量指標的完整指南，專為協助您識別、診斷與解決 DynamoDB 資料表及索引中的限流問題而設計。

**一般限流度量指標**  
+ `ThrottledRequests`
  + 當請求中的任一事件被限流時，無論該請求包含多少事件，指標都會增加 1。例如，在具有全域次要索引 (GSI) 的資料表中更新項目時，會觸發多個事件：對基礎資料表的寫入，以及對各索引的寫入。若這些事件中的任一被限流，`ThrottledRequests` 度量指標僅會增加一次。

    此行為對理解與診斷 DynamoDB 效能問題極為重要，因其可能掩蓋實際限流程度。若需更完整的洞察，可將 `ThrottledRequests` 度量指標與事件層級指標 (如 `ReadThrottleEvents`、`WriteThrottleEvents`) 及特定目標指標 (如 `ReadKeyRangeThroughputThrottleEvents`) 進行比較。本頁提供所有依原因分類的度量指標完整清單。每個度量指標對應於限流例外中所記錄的特定限流原因。如需在限流事件期間取得與解析這些原因的說明，請參閱 [限流診斷](throttling-diagnosing-workflow.md) 章節，其中提供識別並解決限流根本原因的步驟。
+ `ReadThrottleEvents`
  + 注意超出資料表或 GSI 佈建 RCU 的請求。
+ `WriteThrottleEvents`
  + 注意超出資料表或 GSI 佈建 WCU 的請求。

**依原因分類的詳細限流度量指標**  
**隨需輸送量限流**  
+ `ReadMaxOnDemandThroughputThrottleEvents`
  + 因隨需模式達最大輸送量而被限流的讀取請求數。
+ `WriteMaxOnDemandThroughputThrottleEvents`
  + 因隨需模式達最大輸送量而被限流的寫入請求數。
**帳戶層級限流**  
+ `ReadAccountLimitThrottleEvents`
  + 因帳戶限制而被限流的讀取請求數。
+ `WriteAccountLimitThrottleEvents`
  + 因帳戶限制而被限流的寫入請求數。
**分割區層級限流**  
+ `ReadKeyRangeThroughputThrottleEvents`
  + 因分割區限制而被限流的讀取請求數。
+ `WriteKeyRangeThroughputThrottleEvents`
  + 因分割區限制而被限流的寫入請求數。

**容量分析度量指標**  
+ `OnlineIndexConsumedWriteCapacity`
  + 當您將新 GSI 新增至現有資料表時，DynamoDB 會執行回填程序，將基礎資料表的資料複製到新索引中。此程序會耗用寫入容量單位。`OnlineIndexConsumedWriteCapacity` 度量指標會追蹤此特定耗用量。

     此耗用獨立於 `ConsumedWriteCapacityUnits` 所追蹤的常規寫入操作，並屬額外耗用。GSI 的常規 `ConsumedWriteCapacityUnits` 度量指標不包含初始建立索引期間所耗用的寫入容量。
+ `ProvisionedReadCapacityUnits` 和 `ProvisionedWriteCapacityUnits`
  + 檢視在指定時段，針對資料表或指定的全域次要索引耗用了多少已佈建的讀取或寫入容量單位。
  + 請注意，`TableName` 維度預設僅針對資料表傳回 `ProvisionedReadCapacityUnits`。若要檢視全域次要索引的已佈建讀取或寫入容量單位，必須同時指定 `TableName` 與 `GlobalSecondaryIndexName`。
+ `ConsumedReadCapacityUnits` 和 `ConsumedWriteCapacityUnits`
  + 檢視指定時間範圍內耗用的讀取與寫入容量單位。`ConsumedWriteCapacityUnits` 不包含初始建立索引期間的寫入容量耗用。

如需 DynamoDB CloudWatch 度量指標的詳細資訊，請參閱 [DynamoDB 指標和維度](metrics-dimensions.md)。