Skip to main content

Search Troubleshooting in Upsearch

This page serves as a guide for resolving search issues with products, brands, categories, or other objects in the Upsearch system. The diagram and checklists below will guide you step by step through possible causes of search problems.

Decision Diagram​

Search Diagnostics

The diagram covers the entire process:

  • From verifying whether the product is included in the source XML feed,
  • through checking the database (elastic_items) and synchronization (sync = 1),
  • to checking upload to Elasticsearch and relevance tuning configuration.

Link to the full version of the diagram: /img/diagram.png

Search Issues Checklist (Upsearch)​

1. Search returns no results / doesn't work​

  • Is the Elasticsearch server available?
  • Does the REST API return an error (e.g., 500 or 503)?
  • Does Upsearch work on another project?
  • Are all Elasticsearch indices "green" and "open"?
  • Can the index be opened with the command POST index_name/_open?
  • Is the product in the source XML feed?
  • Does the product have a unique and filled unique key?
  • Was the product successfully processed from XML in the last 2 hours? (not in "items with error"?)
  • Is the product in the database table elastic_items?
  • Does it have sync = 1 in the database?
  • Is the product uploaded to Elasticsearch (visible in "Documents")?
  • Was it not removed by cron (e.g., not in the feed)?
  • Is "search in this collection" active in settings?
  • Is there an error in relevance settings (Text Search, Fuzzy, Stemmer, Autocomplete)?

3. Category or brand cannot be found in autocomplete​

  • Is the parameter marked as Autocomplete Search in relevance tuning?
  • Does it have sufficient weight (~1)?
  • Is the object checked as search in this collection - Autocomplete in result settings?
  • Is the category in the feed? And correctly mapped?

4. Deleted product still appears in results​

  • Is the product not in the source XML feed?
  • Has a reindex or data refresh been performed?
  • Is the cleaner.php cron running?

Contacts​

For technical questions, contact:

  • Development Lead: Jakub Kratina - kratina@praguebest.cz
  • Project Manager: Prokop Blumel, Ales Pribramsky

This document is a living document and should be regularly updated with new information and procedures.