What do the columns in the Object Alloc instrument mean?

Question

I was unable to find the documentation for this. There is no Quick Info.

The columns have these opaque titles:

Category

Live Bytes

# Living

# Transitory

Overall Bytes

# Overall

# Allocations (Net / Overall)

---

Is there a document that shows what these columns mean? Without having to read 600 pages?

Answer 1

The "Analyzing Data with the ObjectAlloc Instrument" section of the Instruments User Guide used to provide some description of the detail view for this instrument (the whole guide has since been rewritten):

The Detail pane (while it is in Table mode) displays other useful information to help you spot potential allocation issues. The net versus overall allocations column of the table shows a histogram of the currently active objects and the total number that were ever created. As the ratio of net allocations to overall allocations shrinks, the color of the histogram bar changes. Blue histogram bars represent a reasonable ratio while colors shifted towards the red spectrum represent lower ratios that might warrant some investigation.

Object allocations are grouped by type, which is what appears under the Category header. The Live Bytes column indicates how many of this type of object have been allocated and still are around in memory. Likewise, the # Living column tells you how many objects of this type are still around in memory. The Overall Bytes and # Overall columns show the total size in memory and number of all allocated objects of that type, whether or not they are still around in memory at this time. Finally, the # Transitory is simply the difference between # Living and # Overall, showing how many objects of that type were created and destroyed during the time period you are analyzing.

The histogram at the right of this table is described by the above-quoted section from the documentation, but it simply provides a graphical measure of the numbers described above.

Answer 2

Here's some more information on Instruments... The link in the approved answer's link reroute doesn't work.

https://developer.apple.com/library/mac/#documentation/developertools/conceptual/InstrumentsUserGuide/Built-InInstruments/Built-InInstruments.html

This also breaks down what the colors of the bars mean...

*Scroll down about half way to the Allocations section.

[updated link, you should be able to find the info in here.]

https://developer.apple.com/library/mac/#documentation/developertools/conceptual/InstrumentsUserGuide/Introduction/Introduction.html