Home | History | Annotate | Download | only in tools 
      1 #!/usr/bin/env python
      2 #
      3 # Copyright 2009 the V8 project authors. All rights reserved.
      4 # Redistribution and use in source and binary forms, with or without
      5 # modification, are permitted provided that the following conditions are
      6 # met:
      7 #
      8 #     * Redistributions of source code must retain the above copyright
      9 #       notice, this list of conditions and the following disclaimer.
     10 #     * Redistributions in binary form must reproduce the above
     11 #       copyright notice, this list of conditions and the following
     12 #       disclaimer in the documentation and/or other materials provided
     13 #       with the distribution.
     14 #     * Neither the name of Google Inc. nor the names of its
     15 #       contributors may be used to endorse or promote products derived
     16 #       from this software without specific prior written permission.
     17 #
     18 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     19 # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     20 # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
     21 # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
     22 # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
     23 # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
     24 # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
     25 # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
     26 # THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
     27 # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
     28 # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
     29 
     30 # This is an utility for converting V8 heap logs into .hp files that can
     31 # be further processed using 'hp2ps' tool (bundled with GHC and Valgrind)
     32 # to produce heap usage histograms.
     33 
     34 # Sample usage:
     35 # $ ./shell --log-gc script.js
     36 # $ tools/process-heap-prof.py v8.log | hp2ps -c > script-heap-graph.ps
     37 # ('-c' enables color, see hp2ps manual page for more options)
     38 # or
     39 # $ tools/process-heap-prof.py --js-cons-profile v8.log | hp2ps -c > script-heap-graph.ps
     40 # to get JS constructor profile
     41 
     42 
     43 import csv, sys, time, optparse
     44 
     45 def ProcessLogFile(filename, options):
     46   if options.js_cons_profile:
     47     itemname = 'heap-js-cons-item'
     48   else:
     49     itemname = 'heap-sample-item'
     50 
     51   first_call_time = None
     52   sample_time = 0.0
     53   sampling = False
     54   try:
     55     logfile = open(filename, 'rb')
     56     try:
     57       logreader = csv.reader(logfile)
     58 
     59       print('JOB "v8"')
     60       print('DATE "%s"' % time.asctime(time.localtime()))
     61       print('SAMPLE_UNIT "seconds"')
     62       print('VALUE_UNIT "bytes"')
     63 
     64       for row in logreader:
     65         if row[0] == 'heap-sample-begin' and row[1] == 'Heap':
     66           sample_time = float(row[3])/1000.0
     67           if first_call_time == None:
     68             first_call_time = sample_time
     69           sample_time -= first_call_time
     70           print('BEGIN_SAMPLE %.2f' % sample_time)
     71           sampling = True
     72         elif row[0] == 'heap-sample-end' and row[1] == 'Heap':
     73           print('END_SAMPLE %.2f' % sample_time)
     74           sampling = False
     75         elif row[0] == itemname and sampling:
     76           print(row[1]),
     77           if options.count:
     78             print('%d' % (int(row[2]))),
     79           if options.size:
     80             print('%d' % (int(row[3]))),
     81           print
     82     finally:
     83       logfile.close()
     84   except:
     85     sys.exit('can\'t open %s' % filename)
     86 
     87 
     88 def BuildOptions():
     89   result = optparse.OptionParser()
     90   result.add_option("--js_cons_profile", help="Constructor profile",
     91       default=False, action="store_true")
     92   result.add_option("--size", help="Report object size",
     93       default=False, action="store_true")
     94   result.add_option("--count", help="Report object count",
     95       default=False, action="store_true")
     96   return result
     97 
     98 
     99 def ProcessOptions(options):
    100   if not options.size and not options.count:
    101     options.size = True
    102   return True
    103 
    104 
    105 def Main():
    106   parser = BuildOptions()
    107   (options, args) = parser.parse_args()
    108   if not ProcessOptions(options):
    109     parser.print_help()
    110     sys.exit();
    111 
    112   if not args:
    113     print "Missing logfile"
    114     sys.exit();
    115 
    116   ProcessLogFile(args[0], options)
    117 
    118 
    119 if __name__ == '__main__':
    120   sys.exit(Main())
    121