~bzr-pqm/bzr/bzr.dev

« back to all changes in this revision

Viewing changes to doc/developers/profiling.txt

• browse files at revision 2625.10.1
• compare with another revision
• download diff
• download tarball
• view history from revision 2625.10.1

• reverse the comparison (2625.10.1 to 1092.1.6)
• stop comparing with revision 1092.1.6

Show diffs side-by-side

added

removed

doc/developers/profiling.txt

 

1

Profiling

 

2

=========

 

3

 

 

4

Bazaar has some built-in support for collecting and saving profiling

 

5

information. In the simpliest case, the --lsprof option can be used as

 

6

shown below::

 

7

 

 

8

  bzr --lsprof ...

 

9

 

 

10

This will dump the profiling information to stdout before exiting.

 

11

Alternatively, the --lsprof-file option can be used to specify a filename

 

12

to save the profiling data into to. By default, profiling data saved to a

 

13

file is a pickled Python object making it possible to reload the data and

 

14

do with it what you will. For convenience though:

 

15

 

 

16

* if the filename ends in ".txt", it will be dumped in a text format.

 

17

 

 

18

* if the filename ends in ".callgrind", it will be converted to a format

 

19

  loadable by the KCacheGrind visualization tool.

 

20

 

 

21

Here is an example of how to use the --lsprof-file option in combination

 

22

with KCacheGrind to visualize what the "status" command is doing::

 

23

 

 

24

  bzr --lsprof-file status001.callgrind status

 

25

  kcachegrind status001.callgrind &

 

26

 

 

27

.. Note:: bzr also has a --profile option that uses the hotshot profiler

 

28

   instead of the lsprof profiler. The hotshot profiler can be useful

 

29

   though the lsprof one is generally recommended. See

 

30

   http://docs.python.org/lib/node795.html.

 

31

 

 

32

Note that to use --lsprof you must install the lsprof module, which you

 

33

can get with::

 

34

 

 

35

  svn co http://codespeak.net/svn/user/arigo/hack/misc/lsprof

 

36

 

 

37

 

 

38

Profiling locks

 

39

---------------

 

40

 

 

41

Bazaar can log when locks are taken or released, which can help in

 

42

identifying unnecessary lock traffic.  This is activated by the ``-Dlock``

 

43

global option.

 

44

 

 

45

This writes messages into ~/.bzr.log.

 

46

At present this only logs actions relating to the on-disk lockdir.  It 

 

47

doesn't describe actions on in-memory lock counters, or OS locks (which

 

48

are used for dirstate.)

• Older »

Loggerhead is a web-based interface for Breezy
Version: 2.0.1