Pourquoi mon domaine OpenSearch Service est-il bloqué à l'état « Modification » ?

Résolution

Pour résoudre les problèmes liés à un domaine bloqué à l’état Modification, effectuez les actions de dépannage suivantes en fonction du problème rencontré.

Un contrôle de validation échoue avec des erreurs

Lorsque vous initiez une modification de configuration, OpenSearch Service effectue des contrôles de validation pour s'assurer que votre domaine est éligible à une mise à niveau. Si la validation échoue, votre domaine demeure à l’état Modifcation. Pour résoudre ce problème, suivez les étapes de dépannage correspondant à l'erreur affichée. Puis, essayez à nouveau de modifier la configuration.

Vous avez lancé plusieurs modifications de configuration

Il n’est pas possible d’appliquer un nouveau changement de configuration lorsqu'une modification de configuration est en cours. Pour effectuer plusieurs mises à jour de configuration, incluez toutes les modifications dans une seule requête. Si vous soumettez des modifications simultanées, le message d'erreur « A change is already in progress » s'affiche.

Les contrôles de validation demeurent valides pendant toute la durée du changement de configuration. Si votre configuration passe l'étape Validation, ne modifiez les ressources dont votre domaine a besoin qu’une fois la modification initiale terminée. Par exemple, ne désactivez pas la clé AWS Key Management Service (AWS KMS) que vous utilisez pour le chiffrement.

Aucune adresse IP n'est disponible dans les sous-réseaux du VPC

Si le nombre d'adresses IP disponibles est insuffisant, libérez ou ajoutez-en de nouvelles dans les blocs CIDR du sous-réseau du cloud privé virtuel (VPC).

La migration des partitions vers le nouvel ensemble de nœuds de données ne se termine pas

Vérifier la progression de la migration de vos partitions

Une fois qu'OpenSearch Service a créé les nouvelles ressources, il commence à migrer les partitions vers les nouveaux nœuds de données. Ce processus peut prendre entre quelques minutes et plusieurs heures en fonction de la charge et de la taille du cluster.

Pour surveiller l'état de migration des partitions, exécutez la commande suivante :

GET /DOMAIN_ENDPOINT/_cat/recovery?active_only=true&v

Remarque : Remplacez DOMAIN_ENDPOINT par le point de terminaison de votre domaine. Si vous utilisez OpenSearch Dashboards pour exécuter la commande précédente, supprimez /DOMAIN_ENDPOINT/.

Si votre cluster OpenSearch Service se trouve à l’état de cluster rouge, la migration des partitions échoue. Pour résoudre ce problème, consultez la section Pourquoi mon cluster OpenSearch Service se trouve-t-il à l’état rouge ou jaune ?

Pour afficher la taille de vos partitions, exécutez la commande suivante :

GET /_cat/shards?v

Exécutez ensuite la commande suivante pour afficher le nombre de partitions attribuées à chaque nœud :

GET /_cat/allocation?v

Si les nouveaux nœuds ne possèdent pas toutes les partitions requises, exécutez la commande suivante pour en identifier la cause :

GET /_cluster/allocation/explain?pretty

Pour plus d'informations, consultez les pages API de partitions CAT, API d’allocation CAT et API de description de l’allocation du cluster sur le site Web d'OpenSearch.

Utiliser les bonnes pratiques d'OpenSearch Service

Pour accélérer la migration des partitions, respectez les bonnes pratiques suivantes :

• Utilisez une stratégie de partition adaptée à vos besoins.
• Planifiez la croissance et le type de charge de travail lorsque vous choisissez le nombre de partitions pour votre index.
• Assurez-vous que la pression sur le processeur et la mémoire de la machine virtuelle Java (JVM) du cluster n'est pas trop élevée.
• Assurez-vous que l’espace de stockage disponible dans le nouvel ensemble de nœuds est suffisant. Pour libérer de l'espace de stockage, supprimez les index dont vous n'avez plus besoin. Pour obtenir des instructions, consultez la section Supprimer l'API d'index sur le site Web d'OpenSearch.
  Remarque : Des problèmes d’espace de stockage peuvent survenir si vous ajoutez de nouvelles données au cluster pendant le processus de déploiement bleu/vert. Ils se produisent également si les nœuds précédents contiennent de grandes partitions qu'OpenSearch Service ne peut pas allouer aux nouveaux nœuds.

Mettre à jour la valeur de nouvelle tentative d'allocation

Si votre partition dépasse le nombre maximal de tentatives et n'est toujours pas attribuée à un nœud, réessayez l'allocation. Par défaut, le cluster alloue à une partition un maximum de 5 nouvelles tentatives d'affilée.

Pour augmenter le nombre de nouvelles tentatives pour la partition, exécutez la commande suivante :

PUT INDEX_NAME/_settings  {
    "index.allocation.max_retries" : 10
}

Remarque : Remplacez INDEX_NAME par le nom de votre index et 10 par le nombre de nouvelles tentatives.

** Vérifier l’existence de problèmes dans les paramètres de votre index**

Les pannes matérielles internes peuvent provoquer le blocage des partitions sur les anciens nœuds de données existants lors de la migration. En fonction de votre problème matériel, OpenSearch Service exécute des scripts pour rétablir les nœuds dans un état sain. Si vous épinglez des partitions à un ensemble de nœuds existant, la migration des partitions peut être bloquée.

Pour vous assurer qu'aucune partition n'est épinglée à des nœuds, exécutez les commandes suivantes pour vérifier les paramètres d'index :

GET /DOMAIN_ENDPOINT/_cluster/allocation/explain?pretty
GET /DOMAIN_ENDPOINT/INDEX_NAME/_settings?pretty

Remarque : Remplacez DOMAIN_ENDPOINT par votre point de terminaison de domaine et INDEX_NAME par votre index. Si vous utilisez OpenSearch Dashboards pour exécuter la commande précédente, supprimez /DOMAIN_ENDPOINT/.

Dans la sortie, vérifiez les paramètres suivants pour identifier les partitions épinglées aux nœuds :

"index.routing.allocation.require._name": "NODE_NAME"
"index.blocks.write": true

Remarque : Remplacez NODE_NAME par le nom de votre nœud.

Si vous voyez apparaître « index.routing.allocation.require._name » : « NODE_NAME » dans vos paramètres d'index, exécutez la commande suivante pour réinitialiser le paramètre :

PUT INDEX_NAME/_settings  {
    "index.routing.allocation.require._name": null
}

Remarque : Remplacez DOMAIN_ENDPOINT par votre point de terminaison de domaine et INDEX_NAME par votre index.

Pour plus d'informations sur les paramètres de partition de votre index, consultez la page Allocation de partitions au niveau de l'index sur le site Web d'Elastic.

Si vous voyez apparaître « index.blocks.write » : true dans les paramètres de votre index, cela signifie que votre index présente un blocage d’écriture. Ce problème de blocage d'écriture peut se produire en raison d'une erreur ClusterBlockException. Pour résoudre l’exception de bloc du cluster, consultez la section Comment résoudre l’erreur 403 « index_create_block_exception » ou « cluster_block_exception » dans OpenSearch Service ?

Pour suivre la progression de votre modification de configuration, exécutez l'API DescribeDomainChangeProgress. Pour les clusters bloqués à l’état Modification ou les domaines bloqués à l’état Suppression des anciennes ressources pendant plus de 24 heures, créez un dossier AWS Support.