The Templates view

Use a template to specify which data you want to view from the log file, and how you want to view it. You can use an existing template or import one from elsewhere. You can also save templates for later use, or for use in batch mode. If the Templates view is closed, click Views > Template View to open it.

Note: The template format changed in version 2.8.1. Templates from earlier releases no longer work and must be re-created.
A template contains the following configuration information:
  • The display units used in the graphs.
  • The types of data to display in the graphs, for example heap size or Java™ VM restarts.
  • Options set in the Preferences menu item, such as the display colors. The Preferences menu item might be under the Window or File menu, depending on your hosting product.

Templates provided

The IBM® Monitoring and Diagnostic Tools - Garbage Collection and Memory Visualizer (GCMV) provides the following templates, which cover a range of common collections of data types to plot:
Memory
Plots Heap size, Used heap (after collection), and JVM restarts. Useful for diagnosing memory leaks or poor heap sizing.
Performance
Plots Mark, Sweep, Pause, Compact times, and JVM restarts. Useful for investigating performance issues.
Unpaused Time
Plots Intervals between garbage collection triggers and Pause times. This template can help determine if an application is spending long periods of time in garbage collection rather than running.
Object Sizes
Plots Heap size, Used heap (after collection), and Requested object sizes triggering allocation failures. This template can help determine if an application is requesting very large objects and triggering excessive garbage collection.
LOA and SOA Sizes
Plots Heap size, Used SOA (small object area), Used LOA (large object area), Used tenured heap, and Used nursery heap (after collection). This template can help determine if there is a problem with the -Xloratio setting.
Generational Heap
Plots Heap size, Free heap, Tenured heap size, Free tenured heap, Nursery size, Free nursery heap, and Tenure age. Useful for diagnosing memory leaks or poor nursery or tenured heap sizings.
Fragmentation
Plots Heap size, Free heap (before collection), and Free heap (after collection). A large amount of free heap before collection might indicate heap fragmentation. A small amount of free heap after collection might indicate that the heap size is too small or the application is holding on to a lot of data.
Compaction Pauses
Plots Heap size, Used heap (after collection), Compact times, and Pause times. This template can help identify whether a restricted heap is causing excessive time spent in compaction.
Native Memory
Plots native memory usage. Useful for diagnosing out-of-memory errors.
NUMA
Non-uniform memory architecture information

Using templates

  • To save a template, right-click in the Templates view or in the Data set tab, and click Export current settings as template.... The template is saved as a .epf file, and also appears in the Templates view.
  • To apply a template to all data sets, including new ones, right-click the template and click Apply template.
  • To import a template, right-click in the Templates view and click Import template ... The template settings are applied to all data sets. You can also right-click in the Data set tab and click Import template .... The imported template appears in the Templates view.
  • To delete a template, right-click the template then click Delete template. The template is removed from the Templates view, however the .epf file is not deleted from disk, so you can import it again at a later date if required.
  • To restore the list of templates to the default setting, right-click in the Templates view and click Reset to default template list.




© Copyright IBM Corporation 2005, 2016.

US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.