Terracotta DB 10.1 | 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 (see the section Using the Configured Connections for details).
You can view:
*Overview statistics concerning this moment in time, in grid form. Select this view by clicking the icon .
*Historical statistics, in chart form. Select this view by clicking the icon .
*Cache size information. Select this view by clicking the icon .
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:OccupiedByteSize
total size of all entries stored on disk
OffHeap:MappingCount
number of entries stored in direct memory
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
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 averaging. For example, the TMC requests 30 samples over the last 5 minutes for display in the Charts panels. The median raw counter values are calculated for each window, from which rates and ratios can be derived.
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.
TMC Caching Overview
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 (TMC Export to Spreadsheet) icon to download a spreadsheet of the currently displayed values.
Use the Filter cache statistics (TMC Stats Selector) 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.
TMC Statistics Chooser
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.
TMC Caching Charts
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 Filter cache statistics (TMC Filter Cache Statistics) 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 (TMC Take Snapshot) icon to download a single PNG file containing the current values of all displayed charts.
Directly under each individual chart, use the Export (TMC Export to PDF) icon or the Export to PNG image (TMC Export to PNG) icon to download the chart in the selected format.
Additional Chart Features
*Temporarily re-arrange charts via drag-and-drop
*Double-click a chart to get an enlarged snapshot
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
TMC Cache Manager Level Sizing
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
TMC Cache Sizing
Use the View By Tier dropdown to view tier-specific sizing information for all caches contained by the selected CacheManager in grid form.
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.

Copyright © 2010-2019 | Software AG, Darmstadt, Germany and/or Software AG USA, Inc., Reston, VA, USA, and/or its subsidiaries and/or its affiliates and/or their licensors.
Innovation Release