doc: describe libvirt client logging

Describe how to configure logging and the admin socket for debugging RBD libvirt clients. Thanks to Jason Dillman <[email protected]> on ceph-devel for this information. Signed-off-by: Ken Dreyer <[email protected]>
iokays · Aug 4, 2016 · 8e8d55b · 8e8d55b
1 parent 367cb84
commit 8e8d55b
Showing 1 changed file with 12 additions and 0 deletions.
diff --git a/doc/rbd/libvirt.rst b/doc/rbd/libvirt.rst
@@ -95,6 +95,18 @@ To configure Ceph for use with ``libvirt``, perform the following steps:
    **NOTE:** You can also use `rbd create`_ to create an image, but we
    recommend ensuring that QEMU is working properly.
 
+.. tip:: Optionally, if you wish to enable debug logs and the admin socket for
+   this client, you can add the following section to ``/etc/ceph/ceph.conf``::
+
+	[client.libvirt]
+	log file = /var/log/ceph/qemu-guest-$pid.log
+	admin socket = /var/run/ceph/$cluster-$type.$id.$pid.$cctid.asok
+
+   The ``client.libvirt`` section name should match the cephx user you created
+   above. If SELinux or AppArmor is enabled, note that this could prevent the
+   client process (qemu via libvirt) from writing the logs or admin socket to
+   the destination locations (``/var/log/ceph`` or ``/var/run/ceph``).
+
 
 
 Preparing the VM Manager