How to Use the Allocation Timeline Tool

Meggin Kearney
Meggin Kearney

Use theAllocation timeline tool to find objects that aren't being properly garbage collected, and continue to retain memory.

How the tool works

AnAllocation timeline report combines the detailed snapshot information of theheap profilerwith the incremental updating and tracking of theTimeline panel. Similar to these tools, tracking heap allocation involves starting a recording, performing a sequence of actions, then stop the recording for analysis.

The tool takes heap snapshots periodically throughout the recording (as frequently as every 50 ms!) and one final snapshot at the end of the recording.

An Allocation timeline example recording.

Note: The number after the @ is an object ID that persists among multiple snapshots taken. Thisallows precise comparison between heap states. Displaying an object's address makes no sense, asobjects are moved during garbage collections.

Record an Allocation timeline report

To begin using theAllocation timeline tool, follow these steps:

  1. Open theMemory panel in DevTools.
  2. Enable theAllocations on timeline profile.
  3. Press theStart button to begin recording.

Record allocations on a timeline' option highlighted.

Read a heap allocation profile

The heap allocation profile shows where objects are being created and identifies the retaining path. In the following snapshot, the bars at the top indicate when new objects are found in the heap.

The height of each bar corresponds to the size of the recently allocated objects, and the color of the bars indicate whether or not those objects are still live in the final heap snapshot. Blue bars indicate objects that are still live at the end of the timeline, Gray bars indicate objects that were allocated during the timeline, but have since been garbage collected:

Allocation timeline recording example.

You can zoom in to filter theConstructor pane to only show objects that were allocated during the specified timeframe. To zoom in, drag your mouse across the timeframe you'd like to focus on in the timeline.

Timeline zoomed in to a single bar.

Clicking on a specific constructor in theConstructor pane will show its retaining tree in theRetainers pane. Examining the retaining path to the object should give you enough information tounderstand why the object was not collected, and you can make the necessary code changes to removethe unnecessary reference.

View memory allocation by function

You can also view memory allocation by JavaScript function. SeeInvestigate memory allocation byfunction for more information.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2024-12-09 UTC.