DynamoDB 專用 CloudWatch Contributor Insights 入門

在主控台中使用 Contributor Insights

1. 登入 AWS 管理主控台，並在 https://console.aws.amazon.com/dynamodb/ 開啟 DynamoDB 主控台。

2. 在主控台左側的導覽窗格中，選擇 Tables (資料表)。

3. 選擇 Music 資料表。

4. 選擇 Monitor (監控) 索引標籤。

5. 選擇開啟 CloudWatch Contributor Insights。

   

6. 在管理 CloudWatch Contributor Insights 設定對話方塊中，將 Music 基礎資料表和 AlbumTitle-index 全域次要索引切換為開啟。

7. 將兩者的僅限流索引鍵模式開關保留在關閉位置，然後選擇儲存變更。

   

   接著將啟用資料表和 GSI 的預設存取和限流索引鍵模式，提供存取和限流項目的監控。將僅限流索引鍵模式開關切換為開啟位置會啟用限流索引鍵模式。

   如果操作失敗，請參閱《Amazon DynamoDB API 參考》中的 DescribeContributorInsights FailureException 找出可能的原因。

8. CloudWatch Contributor Insights 圖表現在可以在 Music 資料表的監控索引標籤找到。由於已啟用存取和限流索引鍵模式，因此可以看到存取和限流項目圖表。

   

切換 Contributor Insights 模式

1. 在資料表的監控索引標籤上，選擇管理 CloudWatch Contributor Insights。

2. 在管理 Contributor Insights 設定對話方塊中，針對每個基礎資料表或 GSI：

   • 開啟或關閉僅限流索引鍵模式，以啟用限流索引鍵模式，或返回預設的存取和限流索引鍵模式。

   • 切換為關閉，以停用資料表或 GSI 的 CloudWatch Contributor Insight。

3. 選擇儲存變更。

   完成後，圖形將反映新模式。

請遵循下列步驟建立 CloudWatch 警示，並在任何分割區索引鍵耗用超過 50,000 個 ConsumedThroughputUnits 或遇到限流時收到通知。

1. 登入 AWS 管理主控台，並在 https://console.aws.amazon.com/cloudwatch/ 開啟 CloudWatch 主控台。

2. 在主控台左側的導覽窗格中，選擇 Contributor Insights。

3. 根據您的模式和您要監控的內容，選擇適當的規則：

   • 對於存取項目監控 (僅限存取和限流索引鍵模式)：選擇 DynamoDBContributorInsights-PKC-Music

   • 對於限流項目監控 (兩種模式)：選擇 DynamoDBContributorInsights-PKT-Music

4. 選擇 Actions (動作) 下拉式功能表。

5. 選擇 View in metrics (在指標中檢視)。

6. 選擇 Max Contributor Value (作者值上限)。

   注意

   只有 Max Contributor Value 和 Maximum 會傳回有用的統計數字。此清單中的其他統計數字不會傳回有意義的值。

   

7. 在 Actions (動作) 欄中，選擇 Create Alarm (建立警示)。

   

8. 輸入適當的閾值並選擇下一步：

   • 對於存取項目 (PKC 規則)：在 ConsumedThroughputUnits 輸入 50000

   • 對於限流項目 (PKT 規則)：在 ThrottleCount 輸入 1，在有任何限流時收到警示

   

9. 如需如何設定警示通知的詳細資訊，請參閱使用 Amazon CloudWatch 警示。

使用 Contributor Insights 的預設設定

1. 在具備存取和限流索引鍵模式的 Music 基礎資料表上啟用 DynamoDB 專用 CloudWatch Contributor Insights。由於 ACCESSED_AND_THROTTLED_KEYS 為預設模式，因此您可以省略 --contributor-insights-mode=ACCESSED_AND_THROTTLED_KEYS 參數。

   aws dynamodb update-contributor-insights \
                       --table-name Music \
                       --contributor-insights-action=ENABLE

2. 在 AlbumTitle-index 全域次要索引上啟用 DynamoDB 專用 Contributor Insights。

   aws dynamodb update-contributor-insights \
                       --table-name Music \
                       --index-name AlbumTitle-index \
                       --contributor-insights-action=ENABLE

3. 取得 Music 資料表及其所有索引的狀態和規則。

   aws dynamodb describe-contributor-insights 
                       --table-name Music

   回應將包含顯示 ACCESSED_AND_THROTTLED_KEYS 的 ContributorInsightsMode 欄位。

4. 列出 Music 資料表及其所有索引的狀態。

   aws dynamodb list-contributor-insights --table-name Music

在限流索引鍵模式中啟用 Contributor Insights

1. 在具備限流索引鍵模式的 Music 基礎資料表上啟用 DynamoDB 專用 CloudWatch Contributor Insights。

   aws dynamodb update-contributor-insights \
       --table-name Music \
       --contributor-insights-action=ENABLE \
       --contributor-insights-mode=THROTTLED_KEYS

2. 在 AlbumTitle-index 全域次要索引的限流索引鍵模式中啟用 Contributor Insights。

   aws dynamodb update-contributor-insights \
       --table-name Music \
       --index-name AlbumTitle-index \
       --contributor-insights-action=ENABLE \
       --contributor-insights-mode=THROTTLED_KEYS

3. 透過描述 Contributor Insights 組態來驗證模式。

   aws dynamodb describe-contributor-insights --table-name Music

   相較於預設模式，回應會將 ContributorInsightsMode 顯示為 THROTTLED_KEYS 並顯示較少的規則。

切換 Contributor Insights 模式

1. 從限流索引鍵模式切換為存取和限流索引鍵模式。

   aws dynamodb update-contributor-insights \
       --table-name Music \
       --contributor-insights-action=ENABLE \
       --contributor-insights-mode=ACCESSED_AND_THROTTLED_KEYS

2. 從存取和限流索引鍵模式切換為限流索引鍵模式。

   aws dynamodb update-contributor-insights \
       --table-name Music \
       --contributor-insights-action=ENABLE \
       --contributor-insights-mode=THROTTLED_KEYS

3. 在轉換期間檢查狀態。

   aws dynamodb describe-contributor-insights --table-name Music

   在模式切換期間，會將 ContributorInsightsStatus 顯示為 ENABLING。完成後，將顯示為 ENABLED 的新模式。

管理 Contributor Insights 設定

1. 在 AlbumTitle-index 全域次要索引上停用 DynamoDB 專用 CloudWatch Contributor Insights。

   aws dynamodb update-contributor-insights \
                       --table-name Music --index-name AlbumTitle-index \
                       --contributor-insights-action=DISABLE

2. 列出您帳戶中的所有 Contributor Insights 組態。

   aws dynamodb list-contributor-insights

   將顯示已啟用 Contributor Insights 的所有資料表和索引，以及其模式。

3. 取得特定組態的詳細資訊。

   aws dynamodb describe-contributor-insights \
                       --table-name Music \
                       --index-name AlbumTitle-index