FAQs and Troubleshooting
By default, all logs are set to “Standard” Monolog\Logger::INFO. To see indexing data in the logs set the Indexing logger to “Verbose” Monolog\Logger::DEBUG. That setting can be found here Stores > Configuration > Klevu > Developer Settings > Logging.
Attribute discovery and attribute sync are triggered on integration as is entity discovery. Entity sync however is handled via cron. Please ensure you have corn running correctly. The indexing cron default schedule is set to every 30 minutes. This can be customised in the admin Stores > Configuration > Klevu > Data Sync > Indexing
As with all cron tasks added by version 4.x of the Klevu integration, order sync cron tasks use the dedicated klevu cron group, allowing granular configuration of scheduling and run options.
We recommend using the native Magento cron to run these jobs, configuring schedules if necessary, rather than a custom server-side cron implementation of the CLI command.
By default, Klevu will index all enabled products/categories/CMS pages. There are admin settings to exclude disabled products/categories/CMS pages or out-of-stock products. If you wish to exclude entities from the sync based on any other attribute you can add an is indexable condition to the determiner via etc/di.xml.
By default, we do not filter products by visibility when indexing data. We have an optional module that can be installed to add the ability to filter products on visibility before indexing.
We have 2 future releases planned:
- integrate your auth keys at website scope (same auth keys for multiple stores).
- indexing visibility for customer groups.
This module would cause issues with either setup as products could have differing visibility between stores and customer groups, potentially triggering a Delete request when the product should be sent to Klevu.
The module can be installed via composer or found on Github
The frontend modules filter search requests based on visibility which matches the default Magento behaviour
- category-search or search for search requests.
- category-search or category for category navigation requests.
The Klevu modules always send a delta sync, i.e. just the products that need to be updated. Which products to send to Klevu is determined by the next_action column in the klevu_indexing_entities. We have a CLI command to set entities to require an update (or addition/deletion if applicable). In that command instead of passing a list of IDs to update we can pass --entity-ids="all". This will set all entities, that are indexable, to require an update. These entities will be synced to Klevu on the next cron run or the sync can be triggered via the sync CLI command.
In Magento 2.4.4 - 2.4.6-p7, there is a bug in Magento MSI where a configurable product became out of stock it would not come back into stock, even if the admin displayed Stock Status: In Stock. This issue was fixed in the 2.4.7 release and can be applied via quality patch ID: ACSD-56546. If that does not fix the issue, please review the 2.4.7 release as there were multiple inventory issues fixed in that release.
