This page last changed on Sep 10, 2008 by smaddox.

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.

To view the cache statistics, do the following.

  1. Go to the Confluence 'Administration Console'. To do this:

    • Open the 'Browse' menu and select 'Confluence Admin'. The 'Administration Console' view will open.
  2. Click 'Cache Statistics' in the left panel. There you will find a list of all objects cached within Confluence.
  3. Click on the 'Advanced' tab for more detail. Below is an example for one of the most frequently used caches, the Content Object cache.
Name Percent Used Effectiveness Objects / Size Hit / Miss / Expiry Flush
Content Object 80% 73% 4023 / 5000 374550 / 140460 / 55044 Flush

About the generated numbers :

Percent Used: =(Objects)/(Size)
Effectiveness: =(Hits)/(Hits + Misses)
Objects / Size: the number of entries in the cache / the number of total possible entries allowed (configurable)
Hit / Miss / Expiry: 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
Flush: flushes the cache

For instance to calculate Percent Used :

Percent Used = Objects / Size

Percent Used = 4023/5000 = 80%

and to calculate Effectiveness :

Effectiveness = (Hits)/(Hits + Misses)

Effectiveness = 374550 / (374550 + 140460) = 73%

The clustered versions of Confluence use distributed cache called Tangosol Coherence.

Cache Key Mappings

In order to find relevant cache key mappings to the friendly cache names displayed on this page, please open your <Confluence-Install>/confluence/web-inf/confluence-x.x.jar/com/atlassian/confluence/core/ConfluenceActionSupport.properties file and look for the # Friendly cache names section, for a complete list.
You may also wish to vote for this improvement request in Jira, to embed these key values in the Cache Statistics page for ease of recovering this information.

Performance Tuning

If you need to tune your application when under high usage, you may like to review this document for suggestions.

RELATED TOPICS
Confluence Cache Schemes
Cache Performance Tuning
Viewing System Information
Cache Performance Tuning for Specific Problems
Viewing and Editing License Details
Cache Statistics

Document generated by Confluence on Dec 03, 2008 15:03