/brz/remove-bazaar

To get this branch, use:
bzr branch http://gegoxaren.bato24.eu/bzr/brz/remove-bazaar

« back to all changes in this revision

Viewing changes to doc/developers/profiling.txt

  • Committer: John Arbash Meinel
  • Date: 2009-08-17 19:31:29 UTC
  • mto: This revision was merged to the branch mainline in revision 4620.
  • Revision ID: john@arbash-meinel.com-20090817193129-0512zwglhybx6eiq
Since the merge depth changed, it causes log to change slightly as well.
Now the intermediate node is considered to be merging the file change, and thus it
also gets included in the per-file output.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/developers/profiling.txt
 
1
Profiling
 
2
=========
 
3
 
 
4
Using profilers
 
5
---------------
 
6
 
 
7
Bazaar has some built-in support for collecting and saving profiling
 
8
information. In the simpliest case, the ``--lsprof`` option can be used as
 
9
shown below::
 
10
 
 
11
  bzr --lsprof ...
 
12
 
 
13
This will dump the profiling information to stdout before exiting.
 
14
Alternatively, the ``--lsprof-file`` option can be used to specify a filename
 
15
to save the profiling data into to. By default, profiling data saved to a
 
16
file is a pickled Python object making it possible to reload the data and
 
17
do with it what you will. For convenience though:
 
18
 
 
19
* if the filename ends in ``.txt``, it will be dumped in a text format.
 
20
 
 
21
* if the filename either starts with ``callgrind.out`` or ends with
 
22
  ``.callgrind``, it will be converted to a format loadable by the
 
23
  KCacheGrind visualization tool.
 
24
 
 
25
Note that KCacheGrind's Open Dialog has a default filter than only shows
 
26
files starting with ``callgrind.out`` so the longer filename is usually
 
27
preferable. Here is an example of how to use the ``--lsprof-file`` option
 
28
in combination with KCacheGrind to visualize what the ``status`` command
 
29
is doing::
 
30
 
 
31
  bzr --lsprof-file callgrind.out.st001 status
 
32
  kcachegrind callgrind.out.st001 &
 
33
 
 
34
.. Note:: bzr also has a ``--profile`` option that uses the hotshot profiler
 
35
   instead of the lsprof profiler. The hotshot profiler can be useful
 
36
   though the lsprof one is generally recommended. See
 
37
   http://docs.python.org/lib/node795.html.
 
38
 
 
39
Note that to use ``--lsprof`` you must install the lsprof module, which you
 
40
can get with::
 
41
 
 
42
  svn co http://codespeak.net/svn/user/arigo/hack/misc/lsprof
 
43
 
 
44
 
 
45
Profiling locks
 
46
---------------
 
47
 
 
48
Bazaar can log when locks are taken or released, which can help in
 
49
identifying unnecessary lock traffic.  This is activated by the ``-Dlock``
 
50
global option.
 
51
 
 
52
This writes messages into ``~/.bzr.log``.
 
53
At present this only logs actions relating to the on-disk lockdir.  It 
 
54
doesn't describe actions on in-memory lock counters, or OS locks (which
 
55
are used for dirstate.)
 
56
 
 
57
 
 
58
Profiling HPSS Requests
 
59
-----------------------
 
60
 
 
61
When trying to improve network performance, it is often useful to know
 
62
what requests are being made, and how long they are taking. The ``-Dhpss``
 
63
global option will enable logging smart server requests, including the
 
64
time spent in each request.