Top 10 Recommendations for Improving the Performance of your Commerce Cloud Promotion Engine
17 min read
The promotions module of SAP Commerce Cloud internally uses a promotion engine that is entrusted to perform evaluations on cart and perform selected actions for eligible carts. The promotion engine is based on Drools engine. The recommendations in this article are aimed at helping you optimize the promotion engine performance through the use of certain tweaks or modifications.
Table of Contents
- Tip #1: Gather Statistics on your Promotions
- Tip #2: Create a RETE Network Visualization of Your Promotions
- Tip #3: Ensure You're on the Latest SAP Commerce Core Patch
- Tip #4: Product Promotions by Discount Row
- Tip #5: Use Virtual Categories and User Groups
- Tip #6: Multi Code Coupon vs Single Code Coupon
- Tip #7: Clean-up Promotion with Maintenance Jobs
- Tip #8: Optimize the KIE Module
- Tip #9: Reduce Number of Promotion Calculation
- Tip#10: Garbage Collection Tuning
Tip #1: Gather Statistics on your Promotions
Before performing any optimization, it is important to identify the root cause of the problem at hand. A simple groovy script executed from the hybris Admin Console (hAC) can provide the information necessary to start the analysis. For example:
Now, analyze the result. Here are some indicators to look for:
- Is the number of active promotions in line with the expected published promotions per website?
- Is the Total published promotions but expired greater than zero?
- Is the Total number of redundant Drools rules greater than zero?
- Look at the structure of the promotions which have their Drools rules content size in Top 10. Why do they have such large Drools rule content size? Are there lots of product, users or any similar entries added directly to the promotion, instead of adding them as categories or user groups?
Tip #2: Create a RETE Network Visualization of Your Promotions
Drools rule engine internally creates a network of conditions, which are evaluated when promotion calculations are triggered. This is called RETE network and there is an Eclipse plugin that can be used to create a visual structure of the conditions for a Rule. Drools rules can be analyzed using this plugin to look for complex evaluations and paths.
Tip #3: Ensure You're on the Latest SAP Commerce Core Patch
Patches are released each month for SAP Commerce, which have included a lot of promotion engine optimizations. If you are not on the latest patch for your version of SAP Commerce, there are chances that you are missing out on some of these easy wins.
A few of the major ones are mentioned below.
in order to use these feature you will need to republish all your published rules as most of these below optimizations require the drools syntax to be regenerated.
This enhancement replaces the currently used RRD objects to track rule and rule group executions and replaces them with the usage of a newly introduced RuleAndRuleGroupExecutionTracker implementation which significantly decreases memory consumption.
This feature is disabled by default and can be enabled by setting the property ruleengineservices.use.deprecated.rrd.objects=false in your local.properties.
Rule Aware Objects (RAO) Model Simplifications
The RAO model has been greatly simplified, leading to less RAO objects included in a rule evaluation, thus improvement in both memory consumption as well as CPU usage.
ProductRAO, CategoryRAO and ProductConsumedRAO are no longer used. Instead all their attributes have been moved (and renamed) to OrderEntryRAO.
Drools Syntax Generation Improvements
Drools syntax is now generated to a more optimized structure, for faster evaluation.
The code generated previously:is now generated using the == and || operators:
Tip #4: Product Promotions by Discount Row
This is a classical design mistake that may lead to an excess number of promotions in the system.
When a cart calculation triggers, it fires the drools engine that internally checks for applicable promotions. This evaluation happens in drools engine based on the various RAOs. Once a matching promotion is found, that has the top most priority, the corresponding action gets applied. These actions are typically a certain discount on the cart. Discounts can be a fixed amount or a percentage amount. Moreover, these can be on the total cart or on specific cart entries.
These discounts are attached to the cart/cart entries as discount rows.
For a simpler kind of promotion, where the condition only contains product, and the action contains a fixed / percentage discount, the same result can rather be achieved instead by directly creating discount rows against the products. What the business team called “product promotions” may be better implemented in SAP Commerce with discounts.
Discount row is more performant, is simpler to import and works natively.
Discount row is less flexible for complex conditions, the cart calculation logic may be different.
Tip #5: Use Virtual Categories and User Groups
Backoffice does not restrict the business users to associate products, users and other similar entries to a condition. Business Users may at times end up associating hundreds of such entries to the promotions, leading to an increased memory and CPU utilization. Over a period, the evaluation and publication time may increase substantially.
A better approach is to merge such large numbers of entries to their corresponding groups, and associate these groups to the promotion.
- Create categories with these products/variants (if it does not already exist). You may call them "Virtual categories", as these may just be used for promotion configuration.
- Create user groups with users (if it does not already exist), and associate that in the promotion
Tip #6: Multi Code Coupon vs Single Code Coupon
SAP Commerce supports two types of coupons:
- Single code coupon: Typically shared with all customers or a group of customers and therefore can be redeemed multiple times.
- Multi code coupon: Generates multiple codes dynamically and each code is typically shared with one customer. These codes are unique and are for one time use only.
If multiple Single code coupons are created instead of Instead of creating Multi code coupons, you may end up with a very high number of coupons, thereby putting higher load on the promotion engine. Ensure you are using the appropriate type of coupon.
Tip #7: Clean-up Promotion with Maintenance Jobs
Over a period, promotion engine tends to accumulate a lot of unused drools rules and promotion source rules. These rules are typically not of much use functionally and therefore it is recommended that proper cleanups are done periodically.
Two types of cleanups are mainly needed.
Cleanup of Inactive Drools Rules:
SAP Commerce comes with a maintenance job - DroolsRulesMaintenanceCleanupJob. This job improves Rule Engine speed and performance by deleting all inactive versions of every Drools rule in your system, leaving only the active drools rules versions.
Refer Maintenance Cron Job for Drools Rules for the steps to enable this job.
Cleanup of Expired Promotion Source Rules:
A lot of promotions are created with end dates. These promotions cease to apply on the cart after the end date. This evaluation of end date constraint takes place in drools engine and is therefore executed every time a cart evaluation takes place. In other words, these promotions do not get removed automatically from Drools engine memory after they have expired.
Over a period, these promotions end up consuming a lot of CPU and memory without adding any functional value. Therefore, it is advised that these promotions are unpublished immediately when they have crossed their end date. Doing this manually can be a pain and the way to automate this using a cleanup job is quite simple.
In the above code, getDate() is used, which works on Microsoft Azure SQL but may need to be replaced with an equivalent code to get the current date/time.
Tip #8: Optimize the KIE Module
Create One KIE module per Website
If you have a setup with multiple sites and the cart is not shared between these different sites, it is advised that separate KIE Modules are created for each site. This will restrict the promotion calculation to the number of promotions associated to the individual websites only, instead of looking at all the promotions available across all the sites.
As mentioned, it works only if you do not mix products from different sites into the same cart.
Remove Preview KIE Modules
In cases where you are not using preview KIE modules, it is advised that you remove them so that it frees the memory used by them. Keep only those KIE modules which are being used.
Tip #9: Reduce Number of Promotion Calculation
Multiple Calls to Promotion Engine in Single Transactions
Are you aware of which activities in your project are triggering a promotion calculation? If not, this can be a good starting point and can lead to quick improvements. Developers tend to unknowingly add multiple cart recalculation calls within a single browser request and this leads to unnecessary load on the system. In these cases, it is usually possible with code optimization to achieve the same result by a single call to promotion engine.
For example, look at the methods invoked when a product is added to the cart. How many times does it call the DefaultPromotionEngineService.evaluate() method? If it is more than once, then possibly, the code can be optimized.
Promotion Engine Calls When Cart Need Not be Re-evaluated
Consider another scenario, where, in the checkout journey the end user is modifying the address parameters. In these cases, the cart total isn't expected to change, therefore a call to promotion engine is not expected. Do these kinds of scenarios invoke promotion engine method? If yes, then this should be reviewed and optimized.
Limit the Number of Cart Items
What is the maximum number of items, your customers are allowed to add into a single cart or wish list? What happens if a few of your customers or bots are adding hundreds of items into cart or wish list? Can you restrict the cart or size to a number that is sufficient enough for your customers? Carts are persisted in application and are retrieved every time the user comes back to a page. If a customer keeps adding items to the cart but does not checkout, this will put undue burden on the system. In such cases, it is advised that you restrict the cart size.
The maximum allowed size can vary depending on the business requirements and the type of products. For groceries and certain B2B sites, this may be a high, but for electronics and apparel, this may be low. You can even look at the historical orders to identify the maximum order size.
Tip#10: Garbage Collection Tuning
Drools engine evaluations happen in-memory and therefore the engine consumes a significant amount of Heap and Metaspace. Drool engine performs just-in-time compilation and therefore, the Metaspace utilization can also increase over a period. When there are high number of promotions, it is advised that the memory is monitored for any full GC in heap and Metaspace, and necessary corrective measures are taken if needed.
Remember that Drools engine, being in-memory, is usually one of the biggest contributor to the Heap and Metaspace, and keeping it in check is goes a long way in keeping the application memory healthy. See Using Dynatrace to Manage and Optimize the Performance of your SAP Commerce Cloud Solution for more.
The Promotion engine is an extremely powerful and agile module that supports creation of various kinds of promotions in-memory. A well managed promotion engine contributes immensely to the overall performance and stability of SAP Commerce application. This article covered some of the fundamental mistakes that are possible in any implementation and provides corrective and preventive measures. Some of these may or may not apply for you depending on the way you have configured promotions in your application.
In general, all the above recommendations to improve promotion engine performance can be grouped under one or more of these high level recommendations:
- Reduce the number of Promotions and resulting Drools rules
- Reduce the size of Drools Rules
- Reduce the number of conditions
- Reduce the number of items in each conditions
- Reduce the number of hits to promotion engine
In your implementation, you can look for any other optimisation around these areas. The approach to run a performance test and optimize your solution is explained in the series of articles under Managing Performance in an SAP Commerce Cloud Project.