Troubleshooting: Solr Search Build Index

When the indexing process does not complete or the expected products do not appear in the search results, it may indicate issues during the Solr index build process. For details on collecting search server trace logs, see Collecting Solr based search-related MustGather data for search build index issues

Problem

The Solr-based search index is either not being created successfully or the expected product updates are not reflected in the search results.

This may happen due to:

The DataImport handler not being invoked.
The indexing process stalling during initialization.
Documents not being added or updated in the index.
The new index not being activated for search.

Example indicators in logs:

Missing /dataimport invocation entries.
No doFullImport Starting Full Import message.
Absence of updateDocument(add{id=...}) entries.
Lack of new searcher registration or warm-up messages.

Solution

To troubleshoot and resolve Solr indexing issues, follow these steps and look for these specific log entries to validate each phase:

Confirm that all the lines listed below are present in the log.

Confirm Index Start via DataImport Handler: Ensure the following log line is present to verify indexing has started:
```
org.apache.solr.core.SolrCore I execute [...] path=/dataimport params={...}
```
Confirm Index Start via DataImport Handler: Ensure the following log line is present to verify indexing has started:
```
org.apache.solr.handler.dataimport.DataImporter I doFullImport Starting Full Import
```
Confirm Index Start via DataImport Handler: Ensure the following log line is present to verify indexing has started:
```
org.apache.solr.update.DirectUpdateHandler2 updateDocument(add{,id=...})
```
Confirm Index Start via DataImport Handler: Ensure the following log line is present to verify indexing has started:
```
org.apache.solr.handler.dataimport.DocBuilder I finish Import completed successfully
```
Confirm Index Start via DataImport Handler: Ensure the following log line is present to verify indexing has started:
```
org.apache.solr.core.SolrDeletionPolicy updateCommits newest commit generation = ...
```
Confirm Index Start via DataImport Handler: Ensure the following log line is present to verify indexing has started:
```
NewSearcherNotifyOnChangeListener I warmSearcher(...) warm started successfully
```
Confirm Index Start via DataImport Handler: Ensure the following log line is present to verify indexing has started:
```
LogUpdateProcessorFactory$LogUpdateProcessor I finish [...] add=[...]
```

Note: These log entries help identify at which stage the indexing process might have failed or stalled. If any of the above logs are missing, investigate that specific phase further for example, data source configuration, transformation logic, commit issues.