Guide - New Cache API - Configuration and Metrics

Table of Contents

Product Version


Product To Version



With release, a new Cache API is introduced, which allows fine grained configuration and invalidation. The new caches are based on Guava cache implementation.


Existing caches must not be migrated, but we recommend to use the new cache API as soon as possible. Some features are:

  • Fully configurable via properties
  • Allow weak references for keys and weak or soft references for values
  • Definition of initial and maximum size
  • Monitoring of caches (sizes, cache hit ration) via Prometheus /metrics endpoint (since version


After introduction the promotion cache was reworked ( Unfortunately, the default configuration of caches leads to an high memory usage of that cache. So we strongly recommend to configure the cache manually.




The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.

The Intershop Customer Portal uses only technically necessary cookies. We do not track visitors or have visitors tracked by 3rd parties. Please find further information on privacy in the Intershop Privacy Policy and Legal Notice.
Customer Support
Knowledge Base
Product Resources