tools/deep_memory_profiler/dmprof.py

   1 # Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 # Use of this source code is governed by a BSD-style license that can be
   3 # found in the LICENSE file.
   4
   5 """The Deep Memory Profiler analyzer script.
   6
   7 See http://dev.chromium.org/developers/deep-memory-profiler for details.
   8 """
   9
  10 import logging
  11 import sys
  12
  13 from lib.exceptions import ParsingException
  14 import subcommands
  15
  16
  17 LOGGER = logging.getLogger('dmprof')
  18
  19
  20 def main():
  21   COMMANDS = {
  22     'buckets': subcommands.BucketsCommand,
  23     'cat': subcommands.CatCommand,
  24     'csv': subcommands.CSVCommand,
  25     'expand': subcommands.ExpandCommand,
  26     'json': subcommands.JSONCommand,
  27     'list': subcommands.ListCommand,
  28     'map': subcommands.MapCommand,
  29     'pprof': subcommands.PProfCommand,
  30     'stacktrace': subcommands.StacktraceCommand,
  31     'upload': subcommands.UploadCommand,
  32   }
  33
  34   if len(sys.argv) < 2 or (not sys.argv[1] in COMMANDS):
  35     sys.stderr.write("""Usage: dmprof <command> [options] [<args>]
  36
  37 Commands:
  38    buckets      Dump a bucket list with resolving symbols
  39    cat          Categorize memory usage (under development)
  40    csv          Classify memory usage in CSV
  41    expand       Show all stacktraces contained in the specified component
  42    json         Classify memory usage in JSON
  43    list         Classify memory usage in simple listing format
  44    map          Show history of mapped regions
  45    pprof        Format the profile dump so that it can be processed by pprof
  46    stacktrace   Convert runtime addresses to symbol names
  47    upload       Upload dumped files
  48
  49 Quick Reference:
  50    dmprof buckets <first-dump>
  51    dmprof cat <first-dump>
  52    dmprof csv [-p POLICY] <first-dump>
  53    dmprof expand <dump> <policy> <component> <depth>
  54    dmprof json [-p POLICY] <first-dump>
  55    dmprof list [-p POLICY] <first-dump>
  56    dmprof map <first-dump> <policy>
  57    dmprof pprof [-c COMPONENT] <dump> <policy>
  58    dmprof stacktrace <dump>
  59    dmprof upload [--gsutil path/to/gsutil] <first-dump> <destination-gs-path>
  60 """)
  61     sys.exit(1)
  62   action = sys.argv.pop(1)
  63
  64   LOGGER.setLevel(logging.DEBUG)
  65   handler = logging.StreamHandler()
  66   handler.setLevel(logging.INFO)
  67   formatter = logging.Formatter('%(message)s')
  68   handler.setFormatter(formatter)
  69   LOGGER.addHandler(handler)
  70
  71   try:
  72     errorcode = COMMANDS[action]().do(sys.argv)
  73   except ParsingException, e:
  74     errorcode = 1
  75     sys.stderr.write('Exit by parsing error: %s\n' % e)
  76
  77   return errorcode
  78
  79
  80 if __name__ == '__main__':
  81   sys.exit(main())