Comment résoudre les erreurs qui surviennent lorsque je change mon type de nœud ElastiCache for Redis ?

Brève description

Voici les causes courantes des erreurs rencontrées lors de la modification du type de nœud ElastiCache for Redis :

• Mémoire insuffisante sur le type de nœud cible
• Capacité insuffisante
• Interfaces réseau Elastic ou adresses IP insuffisantes
• Le type de nœud spécifié n'est pas disponible dans la zone de disponibilité
• La version du moteur Redis ne prend pas en charge le type de nœud ciblé
• Le paramètre ApplyImmediately est défini sur false
• Utilisation intensive des nœuds

Résolution

Remarque : vous pouvez utiliser les événements ElastiCache et AWS CloudTrail pour obtenir des informations supplémentaires et consulter les messages d'erreur.

Mémoire insuffisante sur le type de nœud cible

Si vous ne disposez pas de suffisamment de mémoire sur le type de nœud cible, vous recevrez le message d'erreur suivant :

« 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. »

Cette erreur se produit lorsque la métrique BytesUsedForCache dépasse la capacité maximale de votre type de nœud cible.

Pour résoudre ce problème, assurez-vous que le nouveau type de nœud est de taille suffisante pour prendre en charge toutes vos données ainsi que la surcharge Redis requise. Vérifiez également que l'utilisation totale de la mémoire affichée dans la métrique BytesUsedForCache est inférieure à la capacité maximale de votre type de nœud cible.

Remarque : par défaut, 25 % de la mémoire de chaque nœud de cache est réservée aux utilisations autres que les données et aux écritures en arrière-plan. Ce montant est défini par le paramètre reserved-memory-percent. Cette mémoire réservée limite la mémoire maximale utilisée pour les données de cache à 75 % de la mémoire disponible pour le stockage de données. Pour en savoir plus, consultez la section Paramètres spécifiques aux types de nœud Redis. Pour modifier ce montant, vous devez créer un groupe de paramètres personnalisé. Si vous définissez reserve-memory-percent sur 0, les opérations de cluster telles que les instantanés peuvent échouer. Pour en savoir plus, consultez la page Pourquoi ne puis-je pas réduire la taille de mon cluster ElastiCache ?

Capacité insuffisante

L'erreur InsufficientCacheClusterCapacity indique qu'ElastiCache ne peut pas allouer le nombre d'instances demandé depuis une zone de disponibilité donnée. Pour en savoir plus, consultez la section InsufficientCacheClusterCapacity sur la page Messages d'erreur Amazon ElastiCache.

Interfaces réseau Elastic ou adresses IP insuffisantes

Si les interfaces réseau Elastic ou les adresses IP sont insuffisantes, le message d'erreur suivant s'affiche :

« 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. »

Pour résoudre ce problème, vérifiez que vous disposez d'une capacité suffisante pour vos interfaces réseau Elastic ou vos adresses IP. Pour augmenter votre limite, utilisez les Service Quotas. Pour en savoir plus, consultez la page Comment obtenir des interfaces réseau Elastic supplémentaires lorsque j'atteins la limite dans une région AWS ? Vérifiez également que les sous-réseaux utilisés par le cluster disposent d'un nombre suffisant d'adresses IP libres.

Le type de nœud spécifié n'est pas disponible dans la zone de disponibilité

Si vous utilisez un type de nœud qui n'est pas pris en charge dans une zone de disponibilité donnée, le message d'erreur InvalidParameterValue suivant s'affiche :

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

Pour obtenir plus d'informations sur les types de nœuds disponibles, consultez la page Pourquoi ne puis-je pas réduire la taille de mon cluster ElastiCache ?

Pour répertorier les types de nœuds disponibles, utilisez l'API list-allowed-node-type-modifications. Si certains types de nœud ne sont pas disponibles dans des zones de disponibilité données, ils n’apparaissent pas dans la sortie d'API list-allowed-node-type-modifications. Les nœuds qui n'apparaissent pas dans cette sortie n'apparaissent pas non plus dans le menu déroulant lorsque vous modifiez un cluster via la console de gestion AWS.

La version du moteur Redis ne prend pas en charge le type de nœud cible

Certains types de nœuds nécessitent des versions plus récentes du moteur Redis. Pour en savoir plus, consultez la page Types de nœuds pris en charge. Pour résoudre ce problème, vous devez mettre à niveau la version du moteur Redis avant de mettre à niveau le type de nœud.

Le paramètre « ApplyImmediately » est défini sur « false »

Si le paramètre ApplyImmediately est défini sur false, les modifications apportées aux nœuds du groupe de réplication seront appliquées lors du prochain redémarrage de maintenance ou lors d’un redémarrage en cas d'échec. Si vous souhaitez que vos modifications soient appliquées immédiatement, définissez le paramètre ApplyImmediately sur true.

Remarque : le temps nécessaire à la modification du type de nœud dépend du type de nœud et de la quantité de données contenue dans votre cluster. Il est recommandé d'effectuer la mise à niveau à un moment où le trafic vers le cluster est minimal.

Utilisation intensive des nœuds

Le déroulement d’une charge de travail importante sur le cluster au moment de la modification peut interférer avec les flux de travail ElastiCache. Il est donc recommandé d’initier une modification de nœud pendant les heures de faible trafic de données.