Terracotta 10.11 | Terracotta Management and Monitoring | Using the Ehcache Tab
 
Using the Ehcache Tab
The Ehcache tab of the Detail page contains detailed presentations relating to your caching clients. The Detail page is selectable via buttons in the home page.
You can view:
*Overview statistics concerning this moment in time, in grid form. Select this view by clicking the icon List.
*Historical statistics, in chart form. Select this view by clicking the icon Chart.
*Cache size information. Select this view by clicking the icon Storage Device.
Your caching client automatically gathers and periodically sends to the TMS low-level statistics concerning counters and sizing. From those low-level statistics the TMS can synthesize a variety of derived statistics, such as rates (HitRate) and ratios (HitRatio).
The following categories of statistics are available:
Category
Description
Cache
encompasses all the following caching tiers
OnHeap
the JVM heap tier
OffHeap
the JVM OffHeap (direct memory) tier
Disk
the disk tier
Clustered
the cluster tier
The following raw counter values, as well as associated rate of change, are available for each category listed above:
Counter
Description
<Category>:PutCount
number of times your application has put a new entry into the cache
<Category>:UpdateCount
number of times your application has put a new entry into the cache that replaced an existing entry (same key)
<Category>:RemovalCount
number of times your application explicitly removed an entry from the cache
<Category>:ExpirationCount
number of entries removed from the cache due to an expiration policy (time-to-live, etc.)
<Category>:EvictionCount
number of entries removed from the cache due to space constraints
<Category>:HitCount
number of gets that returned an existing entry
<Category>:HitRatio
ratio of hits to gets
<Category>:MissCount
number of gets that did not return an entry
<Category>:MissRatio
ratio of misses to gets
The following category-specific raw counters are also available:
Counter
Description
Disk:MappingCount
number of entries stored on disk
Disk:AllocatedByteSize
number of bytes allocated for storage. AvailableByteSize = AllocatedByteSize - OccupiedByteSize
Disk:OccupiedByteSize
total size of all entries stored on disk
OffHeap:MappingCount
number of entries stored in direct memory
OffHeap:AllocatedByteSize
number of bytes allocated off heap in memory. AvailableByteSize = AllocatedByteSize - OccupiedByteSize
OffHeap:OccupiedByteSize
total size of all entries stored in direct memory
OnHeap:MappingCount
number of entries that store in regular heap memory
OnHeap:OccupiedByteSize
total size of all entries store in regular heap memory
The following latencies are also available:
Counter
Description
Cache:GetHitLatency
latencies of get operations leading to a cache hit. 4 different percentiles are returned: median, 95th, 99th and maximum.
*Cache:GetHitLatency#50
*Cache:GetHitLatency#95
*Cache:GetHitLatency#99
*Cache:GetHitLatency#100
Cache:GetMissLatency
latencies of get operations leading to a cache miss. 4 different percentiles are returned: median, 95th, 99th and maximum.
*Cache:GetMissLatency#50
*Cache:GetMissLatency#95
*Cache:GetMissLatency#99
*Cache:GetMissLatency#100
Cache:PutLatency
latencies of successful put operations. 4 different percentiles are returned: median, 95th, 99th and maximum.
*Cache:PutLatency#50
*Cache:PutLatency#95
*Cache:PutLatency#99
*Cache:PutLatency#100
Cache:GetRemoveLatency
latencies of successful remove operations. 4 different percentiles are returned: median, 95th, 99th and maximum.
*Cache:RemoveLatency#50
*Cache:RemoveLatency#95
*Cache:RemoveLatency#99
*Cache:RemoveLatency#100
Note:
Ratios and Rates
The TMS gathers raw counters from your application and the servers. Rates of change (rates) and ratios are synthesized based on windowed sample aggregation. The aggregation method depends on the statistic type. For counters and latencies, the maximum value observed during an interval of time is displayed. The TMC requests a different number of samples depending on the chart's time-frame, which will determine the length of the window to use for rates and ratio calculation. The units for rates are always operations per second. Ratios are unitless.
Overview Panel
The Overview Panel lets you view statistics concerning what is happening right now (or just a while ago) with your caching client, broken out by cache. By default the statistics are aggregated across all clients using the same CacheManager. Any particular caching client can also be selected for viewing.
Screenshot: TMC Caching Overview, listing caches and statistics.
Use the CacheManagers dropdown to select the aliased CacheManager for which to show statistics. The entries in this dropdown are of the form CacheManager Alias > Storage Handle due to the fact that different client-side CacheManagers can be configured to use the same storage on the TSA. Furthermore, CacheManagers that are otherwise identical can be configured with different aliases. We show the mapping here so you have a chance to disambiguate CacheManagers should you choose to configure them in this way.
Use the Clients dropdown to select a particular caching client for viewing. By default, statistics are aggregated across all clients of the selected CacheManager.
Additional Grid Features
*Temporarily re-arrange grid columns via drag-and-drop
*Sort on columns or filter on CacheName
*Scroll horizontally if the grid columns overflow the available space
Use the Export (i.e. arrow down) icon to download a spreadsheet of the currently displayed values.
Use the Filter cache statistics (i.e. funnel) icon to select which statistics to display. The set of statistics to view defaults to Cache-level statistics that are applicable to all use-cases.
You can also filter statistics by name, using space-separated terms.
Screenshot: Overlay, choosing statistics
Charts Panel
The Charts Panel lets you view statistics over the past 5 minutes. The TMC requests 30 samples be returned. Unlike the Overview Panel, which shows all the caches contained by the selected CacheManager, the Charts Panel shows statistics for particular caches.
Screenshot: Charts Panel
Use the CacheManagers dropdown to select the aliased CacheManager for which to show statistics. The entries in this dropdown are of the form CacheManager Alias > Storage Handle due to the fact that different client-side CacheManagers can be configured to use the same storage on the TSA. Furthermore, CacheManagers that are otherwise identical can be configured with different aliases. We show the mapping here so you have a chance to disambiguate CacheManagers should you choose to configure them in this way.
Use the Clients dropdown to select a particular caching client for viewing. By default, statistics are aggregated across all clients of the selected CacheManager.
Use the Caches dropdown to select a particular cache for viewing. By default, the first cache listed is selected.
Use the slider () to set how many columns of charts you would like displayed.
Use the events checkbox ( ) to choose whether or not you want to display clients and cache cleared events on the charts. This causes additional dotted lines to appear on the charts, showing the time when the following events occurred: "EC" = Ehcache Cleared, "CJ" = Client Joined, "CL" = Client Left.
Use the Filter cache statistics (i.e. funnnel) icon to select which statistics to display. The set of statistics to view defaults to Cache-level statistics that are applicable to all use-cases.
Use the Take a snapshot of all charts (i.e. camera) icon to download a single PNG file containing the current values of all displayed charts.
Directly under each individual chart, use the Export to PDF (i.e. arrow down) icon or the Export to PNG image (i.e. camera) icon to download the chart in the selected format.
Additional Chart Features
*Rearrange charts via drag-and-drop; the order is preserved until the browser is closed or its cache is manually cleared. If new statistics are selected, they will appear after the charts, and then you can rearrange them.
*Double-click a chart to get an enlarged snapshot
*Check the box named "Events" to display "Client Joined" , "Client Left" and "Ehcache Cleared" events on your charts
Sizing Panel
The Sizing Panel shows how much space is being used by your CacheManagers and caches across the different local storage tiers you've configured. Sizing information related to the Clustered Storage Tier can be accessed via the Remote buttons.
The Sizing Panel is composed of two sections: CacheManager Level Sizing and Cache Level Sizing.
*CacheManager Level Sizing
Screenshot: Sizing Panel
Shown is a pie chart for each local storage tier you've configured for use by your caches, displaying the amount of the available storage that is being used.
Use the CacheManagers dropdown to select the aliased CacheManager for which to display sizing information.
Use the Clients dropdown to select a particular caching client for which to display sizing information. By default the first client listed is selected.
Use the Remote button to navigate to the Resource Usage panel to view how the server-side caching entity is making use of the server’s configured resources, such as OffHeap storage. See the section Resource Usage Panel for related information.
*Cache Level Sizing
Screenshot: Cache Level Sizing
Use the View By Tier dropdown to view tier-specific sizing information for all caches contained by the selected CacheManager in grid form.
Note: 
Byte-sizing Limitations
Cache tiers that are sized by entries cannot provide Occupied Size or Average Entry Size and are displayed as N/A for Not Applicable.
Use the View By Cache dropdown to view the tier usage breakdown for a particular cache, in pie chart form.