← Back to branch summary

~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/profiling.txt

[merge] Storage filename escaping

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.