This server will be upgraded at 3pm Sydney time on December 3rd (December 2nd, 8pm PST) and will be down for up to 30 minutes.
This documentation relates to the latest version of Confluence.
If you are using an earlier version, please go to the documentation home page and select the relevant version.

Cache Statistics

Added by Vidya Madabushi, last edited by Sarah Maddox on Sep 10, 2008  (view change) show comment
All Versions
Click for all versions
Confluence 2.10 Documentation

Index

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
Cache Performance Tuning for Specific Problems
Viewing System Information
Viewing and Editing License Details
Cache Statistics

Labels

mapping mapping Delete
key key Delete
statistics statistics Delete
cache cache Delete
administration administration Delete
system-information system-information Delete
site-administration site-administration Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

Comments (1)

 

  1. Oct 10

    Ben Walding says:

    One thing that can't be determined from the cache statistics is how important it...

    One thing that can't be determined from the cache statistics is how important it is to get hits on a particular cache.

    A poor "effectiveness" ratio on a cache that is expensive to hold (large objects) yet easy to load (simple calculations); may be less valuable than another cache that has small elements that take a lot of calculation.

    I know "Performance Tuning" does talk about some of the items to tune; but it seems like that isn't a complete list.

Add Comment