Add new eventlog events for various heap and GC statistics
authorDuncan Coutts <duncan@well-typed.com>
Mon, 6 Feb 2012 12:22:18 +0000 (12:22 +0000)
committerDuncan Coutts <duncan@well-typed.com>
Wed, 4 Apr 2012 18:10:44 +0000 (19:10 +0100)
commit65aaa9b2715c5245838123f3a0fa5d92e0a66bce
treec590a78588274f19285965d7b5cbd3b051a9329a
parentcd930da1145a0d6094e5b5380034e80d002d5b9a
Add new eventlog events for various heap and GC statistics

They cover much the same info as is available via the GHC.Stats module
or via the '+RTS -s' textual output, but via the eventlog and with a
better sampling frequency.

We have three new generic heap info events and two very GHC-specific
ones. (The hope is the general ones are usable by other implementations
that use the same eventlog system, or indeed not so sensitive to changes
in GHC itself.)

The general ones are:

 * total heap mem allocated since prog start, on a per-HEC basis
 * current size of the heap (MBlocks reserved from OS for the heap)
 * current size of live data in the heap

Currently these are all emitted by GHC at GC time (live data only at
major GC).

The GHC specific ones are:

 * an event giving various static heap paramaters:
   * number of generations (usually 2)
   * max size if any
   * nursary size
   * MBlock and block sizes
 * a event emitted on each GC containing:
   * GC generation (usually just 0,1)
   * total bytes copied
   * bytes lost to heap slop and fragmentation
   * the number of threads in the parallel GC (1 for serial)
   * the maximum number of bytes copied by any par GC thread
   * the total number of bytes copied by all par GC threads
     (these last three can be used to calculate an estimate of the
      work balance in parallel GCs)
includes/rts/EventLogFormat.h
rts/RtsFlags.c
rts/RtsProbes.d
rts/Stats.c
rts/Stats.h
rts/Trace.c
rts/Trace.h
rts/eventlog/EventLog.c
rts/eventlog/EventLog.h
rts/sm/GC.c
rts/sm/Storage.c