10 Monitoring Memory

This chapter describes how to use tracing and the memory monitor to examine an application's memory use on a particular device.

Activating tracing for a particular device enables you to see low-level information as an application runs.

The Memory Monitor shows memory use as an application runs. It displays a dynamic detailed listing of the memory usage per object in table form, and a graphical representation of the memory use over time. You can take a snapshot of the memory monitor data. Snapshots can be loaded and examined later.

Note:

The memory use you observe with the emulator is not exactly the same as the memory use on an external device. Remember, the emulator does not represent an external device. It is one possible implementation of its supported APIs.

10.1 Enabling Tracing

Follow these steps to enable tracing.

In the Device Selector window, right-click a device.
In the properties window for the selected device, go to the Monitor section and check the desired trace options:
- Trace GC (garbage collection). Monitoring GC can help you determine object health. The garbage collector cannot delete objects that do not have a null reference. Dead objects are garbage collected and not reported as live.
- Trace Class Loading. Observing class initialization and loading is useful for determining dependencies among classes.
- Trace Exceptions. Display exceptions caught.
- Trace Method Calls. Reports methods called and returned. The output for this option is very verbose and it can affect performance.
(Optional) Verbose tracing output might cause you to run out of memory on the device before the application is fully tested. You can increase the device memory as follows:
1. In the Properties window, go to the General section.
2. Click Heapsize and select a size.

Tracing data is displayed in the output window (Window > Show View > Console) when an application is run on this device. It is also written to the device log, which is stored in the working directory for the device. For example:

username\javame-sdk\3.4\work\JavaMEPhone1\device.log

You can also access the tracing data by clicking the View menu on the emulator and selecting Device Log. Additionally, you can select Output Console from the View menu to see system information.

10.2 Using the Memory Monitor

Follow these steps to examine an application's memory use.

WARNING:

Do not suspend the emulator while using the memory monitor.

Right-click a project and select Profile As... and then Memory Monitor from the context menu.

If the profiler is not yet integrated you are prompted to enable profiling for the project:
1. Click Yes to continue.
2. Select Memory Monitor in the Profile window that opens.
The Console window tab is labeled "Memory Monitor" indicating that the memory monitor is active for this session. The Console window displays both application status and tracing outputs for this device.
Interact with the application as usual.

In the Memory Monitor tab, you see displayed on the graph above and in the object table below.

To the left of the graph you see the Current memory use in bytes. The green line plots these values. The red line is the maximum amount of memory used since program execution, corresponding to the Maximum size in bytes on the left.

The object table columns are as follows:
- Name. Object class name.
- Total. Total number of objects allocated since the application began.
- Total Size. Total amount of memory the object uses in bytes.
- Average Size. Average object size in bytes, calculated by dividing the number of live instances by the total size.
Beneath the table you see counters displaying the total number of objects, the amount of memory used, the amount of free memory, and the total amount of memory on the device.

Figure 10-1 The Memory Monitor Screen

Description of "Figure 10-1 The Memory Monitor Screen"
Interact with the object table while the memory monitor is running.
- Click a column header to sort the data. The sorting is case sensitive.
- Click a row and the call stack tree is displayed in the window to the right of the table.
  - Click a folder to browse the call stacks tree to see the methods that create the object.
  - To find a particular method in the call stacks tree, click the Find button and enter a search string.
  - Click Refresh to update the call stacks tree as data is gathered. It is not refreshed automatically.
Take a snapshot of the memory monitor. Because the data changes rapidly it is convenient to take several snapshots and review them later.

Click the File menu and select Save. Specify a file name and location for the monitor data. The automatically supplied extension is .mms.
Exit the application.

Some applications contain multiple MIDlets.
- When you exit a MIDlet the table data is cleared.
- The graph data is not cleared when you exit a MIDlet. The graph data you see is cumulative for this emulator session. The memory monitor plots session data for any MIDlet run on the current emulator until you exit the application and close the emulator.

10.3 Saving and Viewing a Session Snapshot

You can take a snapshot of a current memory monitor session by clicking the File menu and selecting Save As... during the session. The file is saved as a .mms file.

Follow these steps to reload a memory monitor snapshot.

Click the File menu and select Open File... .
Select an .mms file you saved.

The memory monitor opens in its own tab in the main window. Note the tab displays the time the snapshot was taken.