OpenSearch Tableaux de bord de résolution des problèmes

Les tableaux de bord s'affichent OpenSearch Dashboards server is not ready yet (une erreur HTTP 503 n'est pas prêt) et le chargement n'est pas terminé. Les tableaux de bord affichent cette page chaque fois qu'elle n'a pas fini de démarrer. Une version brève est normale lors d'un redémarrage, d'une mise à niveau ou d'un blue/green déploiement et s'efface d'elle-même. Traitez-le comme un problème s'il persiste. Pour identifier la cause, vérifiez l'état du cluster du domaine et vérifiez si une modification de configuration ou une mise à niveau est en cours :

Les tableaux de bord indiquent que « le serveur n'est pas encore prêt » tant que tous ses principaux services ne sont pas encore initialisés. C'est pourquoi une version transitoire du message est attendue lors du démarrage et des déploiements. blue/green Lorsqu'un cluster vert persiste, la cause la plus courante est le blocage de la migration de l'index OpenSearch Dashboards : au démarrage, Dashboards migre ses objets enregistrés vers un nouvel index sous un alias, et si cette migration ne peut pas être terminée, Dashboards ne sera jamais prêt. Déclencheurs courants d'une migration bloquée :

Conservez la version actuelle du logiciel de service de votre domaine et prenez un instantané avant chaque mise à niveau. Si vous utilisez les tableaux de bord pour la surveillance de la production, pensez à la centralisationUtilisation de l' OpenSearch interface utilisateur dans Amazon OpenSearch Service, qui n'est pas liée à la migration de l'index des OpenSearch tableaux de bord par domaine d'un seul domaine.

Les tableaux de bord ne se chargent pas et affichent un message similaire au suivant :

Kibana must be able to specify the index within Elasticsearch multi-requests (rest.action.multi.allow_explicit_index=true).

L'option de cluster rest.action.multi.allow_explicit_index avancée est définie surfalse. Définissez cette option sur true afin que Dashboards puisse effectuer ses opérations en bloc, mget et msearch.

rest.action.multi.allow_explicit_indexRevenez à true dans les options avancées du domaine. Il s'agit d'une modification du plan de gestion que vous apportez avec vos propres AWS informations d'identification, soit dans la console (ouvrez le domaine, choisissez Modifier et mettez à jour les paramètres avancés du cluster), soit via l'interface de ligne de AWS commande (AWS CLI) :

aws opensearch update-domain-config \
  --domain-name my-domain \
  --advanced-options rest.action.multi.allow_explicit_index=true

La modification d'une option avancée déclenche un blue/green déploiement. La modification prend donc quelques minutes pour s'appliquer. Pour plus d'informations sur les paramètres de cluster avancés, consultezParamètres avancés du cluster.

Ne définissez pas cette valeurrest.action.multi.allow_explicit_index, false sauf si vous avez l'intention de restreindre l'accès à l'index par le biais de politiques basées sur les ressources. Si vous le laissez sur la valeur par défaut (true), les tableaux de bord restent opérationnels.

Les tableaux de bord redémarrent, se bloquent ou ne répondent plus lorsqu'ils sont chargés, en particulier lors de l'ouverture de grands tableaux de bord ou du chargement de nombreux objets enregistrés.

Le processus des tableaux de bord a épuisé la mémoire disponible, souvent en raison du chargement d'un trop grand nombre d'objets enregistrés ou du rendu de tableaux de bord volumineux.

Pour détecter ce problème avant que Dashboards ne soit à court de mémoire, observez la OpenSearchDashboardsHeapUtilization CloudWatch métrique ; si elle dépasse régulièrement 80 %, passez à un type d'instance plus important. Right-size votre type d'instance pour l'utilisation de vos tableaux de bord, maintenez les tableaux de bord allégés et évitez de les augmenter savedObjects:listingLimit au-delà de ce dont vous avez besoin.

Certaines pages de tableaux de bord ne se chargent pas car la charge utile de la demande dépasse la limite de charge utile du tableau de bord (server.maxPayloadBytesqui est par défaut de 1 Mo/1 048 576 octets).

Les modèles d'index qui correspondent à un très grand nombre d'index ou de champs génèrent des demandes supérieures à la limite de charge utile.

Veillez à ce que les modèles d'index soient limités aux index et aux champs que vous utilisez réellement afin que les demandes respectent la limite de charge utile.

Les tableaux de bord ne sont pas disponibles pendant la majeure partie de la durée d'un déploiement de mise à niveau de version blue/green du moteur. Il s'agit d'un comportement attendu, et non d'une erreur, qui se résout de lui-même une fois la mise à niveau terminée.

Les tableaux de bord restent hors ligne pendant la majeure partie d'une mise à niveau de version afin d'éviter les conditions de course entre les anciens et les nouveaux environnements en matière de vérification des versions.

Attendez que la mise à niveau soit terminée ; les tableaux de bord redeviennent automatiquement disponibles. Traitez les mises à niveau de version comme une période de maintenance planifiée des tableaux de bord et planifiez-les en dehors des heures critiques de l'entreprise. Pour plus d'informations sur les modifications de configuration, consultezApporter des modifications de configuration dans Amazon OpenSearch Service.

Planifiez les mises à niveau pendant les périodes de faible trafic. Si vous avez besoin d'une disponibilité des tableaux de bord qui ne soit pas liée à la fenêtre de mise à niveau d'un seul domaine, pensez à la centralisationUtilisation de l' OpenSearch interface utilisateur dans Amazon OpenSearch Service.

Vous lancez une mise à niveau de version du moteur (ou exécutez le contrôle d'éligibilité à la mise à niveau) et celle-ci échoue lors de la vérification préalable à la mise à niveau, avant le début de toute mise à niveau. La notification de validation répertorie un ou plusieurs index incompatibles et peut nommer spécifiquement l'index OpenSearch des tableaux de bord. Cela se produit généralement lorsque vous effectuez une mise à niveau vers la version OpenSearch 3.x alors que le domaine contient toujours des index créés dans la version OpenSearch 1.3, Elasticsearch 7.10 ou une version antérieure, y compris l'index Dashboards. OpenSearch (Les mises à niveau depuis la version OpenSearch 1.3 ou 2.x doivent d'abord passer à la OpenSearch version 2.19, puis à la version OpenSearch 3.x.)

OpenSearch ne peut lire les index qu'à partir de la version majeure immédiatement précédente. La version OpenSearch 3.x ne prend donc pas en charge les index créés dans les versions OpenSearch 1.3, Elasticsearch 7.10 ou antérieures. La vérification préalable à la mise à niveau bloque la mise à niveau et répertorie ces index exprès, afin que vous ne perdiez aucune donnée. Vous devez réindexer ou supprimer les anciens index avant de procéder à une mise à niveau majeure de version ; le service ne les réindexe pas automatiquement. L'index OpenSearch des tableaux de bord suit la même règle.

Réindexez ou supprimez les anciens index afin qu'ils ne couvrent pas plus d'une version majeure ; les index laissés après plusieurs mises à niveau finiront par en bloquer un. Prenez un instantané manuel avant chaque mise à niveau et exportez régulièrement les objets enregistrés dans vos OpenSearch tableaux de bord en tant que sauvegarde.

Un seul utilisateur ou navigateur voit une page blanche, des rapports vierges ou une bannière rouge indiquant que OpenSearch Dashboards did not load properly. Check the server output for more information. les autres utilisateurs ne sont pas concernés. Confirmez en reproduisant dans une fenêtre privée (navigation privée) ou dans un autre navigateur.

Un cache de navigateur périmé est à l'origine de ce problème, en particulier après une mise à jour du logiciel de service ou lorsque vous utilisez la fonction de création de rapports.

Videz le cache de votre navigateur après une mise à jour du logiciel de service et utilisez un navigateur compatible et à jour.