Cache Statistics
Confluence provides statistics about its internal caches that allow you to track the size and hit ratio of each cache and tune it for better performance (if necessary). See Performance Tuning for more information.
Configurable Caches
System administrators can change the sizes of Confluence's internal caches through the Administration Console and these changes will take effect without the need to first shut down and then restart Confluence. The maximum number of units for any of the defined cache regions can be adjusted individually.
Note that larger cache sizes will require more memory at runtime, so you should review the memory allocation of the Confluence Java process and the physical memory available on your server.
Viewing Cache Statistics and Modifying Cache Sizes
To view the cache statistics:
- Go to
> General Configuration > Cache Management. - Choose Show Advanced View.
Here is an example for one of the most frequently used caches, the 'Content Object' cache.
About the generated numbers:
Capacity Utilization | =(Objects)/(Size) For example Percent Used = 4023 / 5000 = 80% |
|---|---|
Effectiveness: | =(Hits)/(Hits + Misses) For example Effectiveness = 374550 / (374550 + 140460) = 73% |
Current / Max Entries | The number of entries in the cache / the number of total possible entries allowed (this is the size of the cache). |
| Current Heap Size | Heap memory (in MB) allocated to this cache (if applicable) |
Hit / Miss / Evicted | The number of reads accessing cache where required content was found / the number of reads accessing cache where required content was not found / the number of objects evicted from the cache. |
Adjust Size | Use this option to specify a different maximum cache size. |
Flush | Flushes the cache. |
Changes to cache size configurations are saved in the shared-home/config/cache-settings-overrides.properties file in your home directory (in a Confluence Data Center cluster this is in the shared home directory, not local home).
If you need to reset all the values back to the default, you can simply delete the file and restart Confluence.