Unity Objects tab
The Unity Objects tab displays any Unity objects that allocated memory, how much native and managed memory that the object uses, and the combined total. Use this information to identify areas where you can eliminate duplicate memory entries or to find which objects use the most memory. Use the search bar to find the entries in the table which contain the text you enter.
The Unity Objects tab
Note
The search bar can only search for the text shown in the Description column. This will be changed to include other search functionality in future updates.
The following table describes each of the available columns in the table:
Column | Description |
---|---|
Description | Displays the name of each individual object or group of objects. Can't be disabled. |
Allocated Size | Displays how much memory the object or group of objects allocated, in bytes. |
Resident Size | Displays how much memory the object or group of objects is resident, in bytes. |
% Impact | Displays how much memory the object or group of objects uses as a percentage of the Allocated Memory In Table value. All measurement bars, including the Allocated Memory In Table bar, adjust dynamically based on the selected object in the table. |
Native Size | Displays how much of the Allocated Size value is made up of native memory. |
Managed Size | Displays how much of the Allocated Size value is made up of managed memory. |
Graphics Size | Displays how much of the Allocated Size value is made up of graphics memory. |
By default, the table lists all relevant objects by Allocated Size in descending order. You can click on a column header name to sort the table by that column or to change whether the column sorts in ascending or descending order. Hold Ctrl (macOS: Cmd) when you click on a column name to add it to an existing sort. For example, to sort by both Description and Allocated Size, click on the Description header, then hold Ctrl or Cmd and click on the Allocated Size header.
You can continue to hold Ctrl/Cmd and select the header again to toggle between ascending and descending for each individual sorted column. You can sort by any number of columns and in any order - Unity displays a number in each column header to display the sort order, alongside the arrow which indicates whether the Memory Profiler sorts that column in ascending or descending order.
To hide a column, or to display a hidden column, right click on any column header name and select a name from the sub-menu to hide or display that column. You can hide any column except the Description column, which is always visible.
Table mode
Use Table Mode dropdown to see Allocated, Resident Memory usage of allocations, and their relative impact on the total usage. The dropdown changes the memory columns the table displays:
- Allocated Memory - shows only Allocated memory, % Impact is shown against Allocated Memory In Table
- Resident Memory on Device - shows only Resident memory, % Impact is shown against Resident Memory In Table
- Allocated and Resident Memory on Device - shows Allocated and Resident memory, % Impact is shown against Allocated Memory In Table
For more information on the Resident Memory see Memory Usage On Device.
Modifier toggles
There are two toggles you can use to change which entries the table displays, which are both disabled by default:
- Enable the Flatten Hierarchy toggle to expand all objects into single entries instead of collapsible groups.
- Enable the Show Potential Duplicates Only toggle to only display instances where objects might be separate instances of the same object.
The Show Potential Duplicates Only toggle populates the table with information about duplicated memory use. When you enable this toggle, the Memory Profiler window groups any objects in the table with the same name, size, and type together. You can then look through the list to separate any similar objects that should be independent from those that are two instances of the same object.