ceph/doc/install/cpu-profiler.rst
John Wilkins 84eac86696 doc: Added documentation for installing CPU profiler.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2012-11-16 14:57:55 -08:00

55 lines
1.3 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.
.. _logging: ../../rados/configuration/log-and-debug-ref
.. _Ceph Logging and Debugging: ../../rados/configuration/ceph-conf/#ceph-logging-and-debugging
See the `CPU Profiling`_ section of the RADOS Operations documentation for details on using Oprofile.
.. _CPU Profiling: ../../rados/operations/cpu-profiling