Elasticsearch in Adobe Commerce troubleshooter
Elasticsearch issues on Adobe Commerce can be solved using the Elasticsearch troubleshooter tool. Click on each question to reveal the answer in each step of the troubleshooter.
Step 1 - Check for Elasticsearch issue step-1
Elasticsearch issues indicated by error messages, "No alive nodes found in your cluster", missing products, and the display of old product information.
a. YES – Proceed to Step 2.
b. NO – Search again on relevant search terms in the Adobe Commerce Help Center Knowledge Base.
Step 2 - Check for installation issue step-2
b. NO – Check the health of your cluster. If you are on a Pro staging or production environment run this command:
curl -m1 localhost:9200/_cluster/health?pretty
. If you are on an integration environment (that includes all the Starter branches) run curl -m1 elasticsearch.internal:9200/_cluster/health?pretty
. Proceed to Step 3.Step 3 - Check if Elasticsearch cluster available step-3
Step 4 - Verify Elasticsearch cluster healthy step-4
b. NO – Yellow or red means there are problems with connections between nodes, and some data may not be available. If yellow, run the command:
php bin/magento config:show catalog/search/engine
to check your search engine. Proceed to Step 6. If red, submit a support ticket.Step 5 - Verify search working step-5
Symptoms might include no products, empty categories or no updates to products or products categories are not correct.
a. YES – Run this command to check the status of catalog search: php bin/magento indexer:status
. Proceed to Step 8.
b. NO – Run command: php bin/magento config:show catalog/search/engine
. Proceed to Step 6.
Step 6 - Check ElasticSuite step-6
cat composer.lock | grep -A 1 elasticsuite | grep '"version"'
To check if this version is depreciated or recommended, refer to Github: Smile-SA/elaticsuite. If ElasticSuite is up to date proceed to Step 10.b. NO – proceed to Step 7.
Step 7 - Check ECE-tools up-to-date step-7
Run the command: php ./vendor/bin/ece-tools -V
and check ECE-tools version. Is it the latest version of ECE-tools?
a. YES – Proceed to Step 5a.
b. NO – Upgrade ECE-tools to the most current version. Run the command php bin/magento config: show catalog/search/engine
to check your search engine. Proceed to Step 6.
Step 8 - Check for reindexing step-8
b. NO – If the status of catalog search is Reindex required run in CLI/Terminal:
php bin/magento cron:run
. If this does not work, run: php bin/magento indexer:reindex
. If this does not solve the issue, submit a support ticket.Step 9 - Check yaml configuration step-9
.yaml
file recently updated?.yaml
Elasticsearch configuration by referring to DevDocs Set up Elasticsearch: To enable Elasticsearch.b. NO – Submit a support ticket.
Step 10 - Check for tracking indices step-10
Run curl elasticsearch.internal:9200/_cat/indices
(if you are on an integration environment that includes all the Starter branches). If you are on Pro staging or production environment run curl localhost:9200/_cat/indices
. Are there tracking indices listed? Check the output for_tracking_log_
.
a. YES – If you are on a version of ElasticSuite prior to version 2.8.0 it is recommended that you upgrade to ElasticSuite 2.8.0 to adjust tracking indices retention or disable tracking. If you cannot immediately upgrade you can create a cron to remove tracking indices. However, this could cause performance issues. Once you have upgraded to ElasticSuite 2.8.0 or removed tracking indices run the command (if you are on Pro staging or production environments):localhost:9200/_cat/allocation?v
to check available space. If you are on one of the integration environments (that includes all the Starter branches) run elasticsearch.internal:9200/_cat/allocation?v
. Proceed to Step 11.
b. NO – If you are on Pro staging or production environments run localhost:9200/_cat/allocation?v
and check available space. If you are on one of the integration environments (that includes all the Starter branches) run elasticsearch.internal:9200/_cat/allocation?v
. Proceed to Step 11.
Step 11 - Look up specific error step-11
Adobe Commerce and ES logs, extensions and custom code.
a. YES – Review the Adobe Commerce Help Center Troubleshooting article Ensure Elasticsearch is installed properly or Elasticsearch crashes or has out of memory issues when using ElasticSuite plugin.
b. NO – Proceed to Step 12.
Step 12 - Check available storage step-12
localhost:9200/_cat/allocation?v
(if you are on Pro staging or production environments). If you are on one of the integration environments (that includes all the Starter branches) run: elasticsearch.internal:9200/_cat/allocation?v
. Proceed to Step 11.b. NO – Submit a support ticket.