X-Git-Url: https://git.verplant.org/?a=blobdiff_plain;f=src%2Fcollectd.conf.pod;h=64be99e23a5742639e59f65b2450ee0b20927fba;hb=f46301fdc32e9cd13a757dbc005d2b66d5188193;hp=1310c50d754bcbef6cdce361eeb341960f5dc46c;hpb=a5dc46700b069994d91b92fb46c8b2c2a1468c34;p=collectd.git

diff --git a/src/collectd.conf.pod b/src/collectd.conf.pod
index 1310c50d..64be99e2 100644
--- a/src/collectd.conf.pod
+++ b/src/collectd.conf.pod
@@ -7773,6 +7773,8 @@ option is set to 0, refreshing is disabled completely.
 
 =item B<BlockDevice> I<name:dev>
 
+=item B<BlockDeviceFormat> B<source>|B<target>
+
 =item B<InterfaceDevice> I<name:dev>
 
 =item B<IgnoreSelected> B<true>|B<false>
@@ -7798,6 +7800,55 @@ Example:
 Ignore all I<hdb> devices on any domain, but other block devices (eg. I<hda>)
 will be collected.
 
+If I<BlockDeviceFormat> is set to B<target>, then the device names will be the ones
+in the I<target> node for the device in the XML definition of the domain. The
+default is B<target>. This is the behavior before adding the option.
+
+If I<BlockDeviceFormat> is set to B<source>, then the device names will be the ones
+in the I<source> node for the device in the XML definition of the domain.
+
+Example:
+
+If the domain XML have the following device defined:
+
+   <disk type='block' device='disk'>
+      <driver name='qemu' type='raw' cache='none' io='native' discard='unmap'/>
+      <source dev='/var/lib/libvirt/images/image1.qcow2'/>
+      <target dev='sda' bus='scsi'/>
+      <boot order='2'/>
+      <address type='drive' controller='0' bus='0' target='0' unit='0'/>
+    </disk>
+
+setting 
+
+	 BlockDeviceFormat target
+
+will name the device in the graph as C<sda> 
+
+setting
+ 
+	BlockDeviceFormat source
+
+will name the device in the graph as C<var_lib_libvirt_images_image1.qcow2>
+
+These names will also be part of the RRD filename.
+
+=item B<BlockDeviceFormatBasename> B<false>|B<true>
+
+I<BlockDeviceFormatBasename> - this option is honored if and only if 
+option I<BlockDeviceFormat> is set to B<source>. If set to B<true> then 
+only the last part of the path will be used for device name and naming the
+RRD file.
+
+Example: 
+
+if the device path (source tag) is: C</var/lib/libvirt/images/image1.qcow2>
+
+setting:
+	BlockDeviceFormatBasename true
+
+will set the device name to: C<image1.qcow2>
+
 =item B<HostnameFormat> B<name|uuid|hostname|...>
 
 When the virt plugin logs data, it sets the hostname of the collected data