ceph/doc/dev/cpu-profiler.rst
John Wilkins 8a36503879 doc: Moved CPU Profiler docs to dev.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-10-22 13:22:17 -07:00

54 lines
1.2 KiB
ReStructuredText

=====================
Installing Oprofile
=====================
The easiest way to profile Ceph's CPU consumption is to use the `oprofile`_
system-wide profiler.
.. _oprofile: http://oprofile.sourceforge.net/about/
Installation
============
If you are using a Debian/Ubuntu distribution, you can install ``oprofile`` by
executing the following::
sudo apt-get install oprofile oprofile-gui
Compiling Ceph for Profiling
============================
To compile Ceph for profiling, first clean everything. ::
make distclean
Then, export the following settings so that you can see callgraph output. ::
export CFLAGS="-fno=omit-frame-pointer -O2 -g"
Finally, compile Ceph. ::
./autogen.sh
./configure
make
You can use ``make -j`` to execute multiple jobs depending upon your system. For
example::
make -j4
Ceph Configuration
==================
Ensure that you disable ``lockdep``. Consider setting logging to
levels appropriate for a production cluster. See `Ceph Logging and Debugging`_
for details.
.. _Ceph Logging and Debugging: ../../rados/troubleshooting/log-and-debug
See the `CPU Profiling`_ section of the RADOS Troubleshooting documentation for details on using Oprofile.
.. _CPU Profiling: ../../rados/troubleshooting/cpu-profiling