ceph/doc/dev/cpu-profiler.rst

   1 =====================
   2  Installing Oprofile
   3 =====================
   4
   5 The easiest way to profile Ceph's CPU consumption is to use the `oprofile`_
   6 system-wide profiler.
   7
   8 .. _oprofile: http://oprofile.sourceforge.net/about/
   9
  10 Installation
  11 ============
  12
  13 If you are using a Debian/Ubuntu distribution, you can install ``oprofile`` by
  14 executing the following::
  15
  16         sudo apt-get install oprofile oprofile-gui
  17
  18
  19 Compiling Ceph for Profiling
  20 ============================
  21
  22 To compile Ceph for profiling, first clean everything. ::
  23
  24     git clean -dfx
  25
  26 Finally, compile Ceph. ::
  27
  28         ./do-cmake.sh -DCMAKE_CXX_FLAGS="-fno-omit-frame-pointer -O2 -g"
  29     cd build
  30     cmake --build .
  31
  32 In this command, ``CMAKE_CXX_FLAGS`` is specified. This provides callgraph output.
  33
  34 Ceph Configuration
  35 ==================
  36
  37 Ensure that you disable ``lockdep``. Consider setting logging to
  38 levels appropriate for a production cluster. See `Ceph Logging and Debugging`_
  39 for details.
  40
  41 .. _Ceph Logging and Debugging: ../../rados/troubleshooting/log-and-debug
  42
  43 See the `CPU Profiling`_ section of the RADOS Troubleshooting documentation for details on using Oprofile.
  44
  45
  46 .. _CPU Profiling: ../../rados/troubleshooting/cpu-profiling