Difference between revisions of "Plugin:virt"

From collectd Wiki
Jump to: navigation, search
m (Octo moved page Plugin:libvirt to Plugin:virt: Plugin has been renamed.)
(Rename to "virt".)
Line 1: Line 1:
 
{{Infobox Plugin
 
{{Infobox Plugin
   | Name=libvirt
+
   | Name=virt
 
   | Type=read
 
   | Type=read
 
   | Callbacks={{Callback|config}}, {{Callback|init}}, {{Callback|read}}, {{Callback|shutdown}}
 
   | Callbacks={{Callback|config}}, {{Callback|init}}, {{Callback|read}}, {{Callback|shutdown}}
Line 9: Line 9:
 
   | Manpage={{Manpage|collectd.conf|5|plugin_libvirt}}
 
   | Manpage={{Manpage|collectd.conf|5|plugin_libvirt}}
 
}}
 
}}
The '''libvirt plugin''' uses the virtualization API [http://libvirt.org/ libvirt], created by RedHat's [http://et.redhat.com/ Emerging Technology group], to gather statistics about virtualized guests on a system. This way, you can collect CPU, network interface and block device usage for each guest <em>without</em> installing ''collectd'' on the guest systems. Because the statistics are received from the hypervisor directly, this works not only with para-virtualized hosts, but with hardware virtualized machines, too.
+
The '''virt plugin''' uses the virtualization API [http://libvirt.org/ libvirt], created by RedHat's [http://et.redhat.com/ Emerging Technology group], to gather statistics about virtualized guests on a system. This way, you can collect CPU, network interface and block device usage for each guest <em>without</em> installing ''collectd'' on the guest systems. Because the statistics are received from the hypervisor directly, this works not only with para-virtualized hosts, but with hardware virtualized machines, too.
  
 
The used ''libvirt'' library provides abstracted access to a number of virtualization techniques. At the moment (April 2010), the ''Xen'', ''Qemu'' and ''KVM'' backends are able to provide the collected statistics.
 
The used ''libvirt'' library provides abstracted access to a number of virtualization techniques. At the moment (April 2010), the ''Xen'', ''Qemu'' and ''KVM'' backends are able to provide the collected statistics.
Line 34: Line 34:
  
 
Example graphs showing primarily (virt) cpu usage of two guests - services and webapps.
 
Example graphs showing primarily (virt) cpu usage of two guests - services and webapps.
 +
 +
== History ==
 +
 +
This plugin was originally called ''libvirt'', which caused problems with ''collectd's'' build system due to the <code>lib</code> prefix. It has been renamed to simply ''virt'' in [[version 5.5]].
  
 
== Dependencies ==
 
== Dependencies ==

Revision as of 06:53, 21 May 2015

virt plugin
Type: read
Callbacks: config, init, read, shutdown
Status: supported
First version: 4.3
Copyright: 2007–2008 Red Hat Inc.
2007–2008 Florian octo Forster
License: GPLv2
Manpage: collectd.conf(5)
List of Plugins

The virt plugin uses the virtualization API libvirt, created by RedHat's Emerging Technology group, to gather statistics about virtualized guests on a system. This way, you can collect CPU, network interface and block device usage for each guest without installing collectd on the guest systems. Because the statistics are received from the hypervisor directly, this works not only with para-virtualized hosts, but with hardware virtualized machines, too.

The used libvirt library provides abstracted access to a number of virtualization techniques. At the moment (April 2010), the Xen, Qemu and KVM backends are able to provide the collected statistics.

Other statistics than the ones listed above can not be collected through this plugin. For more detailed statistics you will need to install collectd on each guest and use the Network plugin to transmit the statistics.

The plugin can be configured to only collect specific domains, block devices or interfaces. For a full description of available options please refer to the collectd.conf(5) manual page.

Synopsis

<Plugin "libvirt">
  Connection "xen:///"
  RefreshInterval 60
  #Domain "name"
  #BlockDevice "name:device"
  #InterfaceDevice "name:interface"
  #IgnoreSelected false
  HostnameFormat "name"
</Plugin>

Example graphs

Example graphs of the libvirt plugin.

Example graphs showing primarily (virt) cpu usage of two guests - services and webapps.

History

This plugin was originally called libvirt, which caused problems with collectd's build system due to the lib prefix. It has been renamed to simply virt in version 5.5.

Dependencies