如何對變更 ElastiCache for Redis 節點類型時發生的錯誤進行疑難排解？

簡短描述

以下是變更 Redis 節點類型的 ElastiCache 時發生錯誤的常見原因：

• 目標節點類型上的記憶體不足
• 容量不足
• 彈性網路介面或 IP 位址不足
• 指定的節點類型在可用區域中無法使用
• Redis 引擎版本不支援目標節點類型
• ApplyImmediately 參數設定為 false
• 節點使用量大

解決方法

**注意：**您可以使用 ElastiCache 事件和 AWS CloudTrail 進一步洞察並檢視錯誤訊息。

目標節點類型上的記憶體不足

如果目標節點類型的記憶體不足，則會出現下列錯誤訊息：

"Failed to scale down to cache node type Replication Group <replication_group_name> because the node has insufficient memory.Please select a different node type or reduce current memory usage and retry."

當 BytesUsedForCache 指標高於目標節點類型的最大容量時，會發生此錯誤。

若要解決此錯誤，請確定新節點類型足以容納所有資料和所需的 Redis 開銷。此外，請確定 BytesUsedForCache 指標中顯示的目前總記憶體使用量低於目標節點類型的最大容量。

**注意：**依預設，每個快取節點的 25％ 記憶體保留給非資料使用和背景寫入。此容量在 reserved-memory-percent 參數中設定。這一保留的記憶體將快取資料所使用的記憶體上限降至其可用資料儲存記憶體的 75%。如需詳細資訊，請參閱 Redis 節點類型特定參數。若要修改此容量，請建立自訂參數群組。如果將 reserve-memory-percent 設為 0，則叢集作業 (例如快照) 可能會失敗。如需詳細資訊，請參閱為什麼我無法縮小 ElastiCache 叢集？

容量不足

InsufficientCacheClusterCapacity 錯誤表示 ElastiCache 無法根據要求從指定可用區域分配多個執行個體。如需詳細資訊，請參閱 Amazon ElastiCache 錯誤訊息的 InsufficientCacheClusterCapacity 部分。

彈性網路介面或 IP 位址不足

如果彈性網路介面或 IP 位址不足，則會出現下列錯誤訊息：

"Failed to modify the cache node type to Replication Group <replication_group_name> due to insufficient Elastic Network Interface or free IP address.Please verify your network limits and retry."

若要解決此錯誤，請確定您擁有用於彈性網路介面或 IP 位址的適當容量。若要增加限制，請使用 Service Quotas。如需詳細資訊，請參閱如果我已達到 AWS 區域的限制，如何取得更多彈性網路介面？此外，請確定叢集使用的子網路具有足夠的可用 IP 位址。

指定的節點類型在可用區域中無法使用

如果您使用特定可用區域不支援的節點類型，則會出現下列 InvalidParameterValue 錯誤訊息：

"Specified node type <node_type> is not available in AZ <availability_zone>"

如需可用節點類型的詳細資訊，請參閱為什麼我無法縮小 ElastiCache 叢集？

若要列出可用的節點類型，請使用 list-allowed-node-type-modifications API。如果有任何節點類型在特定可用區域中無法使用，則這些節點類型不會顯示在 list-allowed-node-type-modifications API 輸出中。當您透過 AWS 管理主控台修改叢集時，未出現在此輸出中的節點也不會出現在下拉式功能表中。

Redis 引擎版本不支援目標節點類型

某些節點類型需要較新版本的 Redis 引擎。如需詳細資訊，請參閱支援的節點類型。若要解決此錯誤，請在升級節點類型之前升級 Redis 引擎版本。

ApplyImmediately 參數設定為 false

如果 ApplyImmediately 參數設為 false，則在下次維護重新啟動或失敗重新啟動時，將套用複寫群組中的節點變更。如果您需要變更立即發生，請將 ApplyImmediately 參數設定為 true。

**注意：**節點類型變更需要多長時間取決於節點類型以及叢集中的資料量。最佳做法是在叢集的流量最低時執行升級。

節點使用量大

修改期間叢集上的工作負載重可能會干擾 ElastiCache 工作流程。在資料流量低時啟動節點修改是最佳做法。