How to view 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.

To view the cache statistics, do the following.

  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