2 * collectd - src/libvirt.c
3 * Copyright (C) 2006-2008 Red Hat Inc.
5 * This program is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License as published by the
7 * Free Software Foundation; only version 2 of the license is applicable.
9 * This program is distributed in the hope that it will be useful, but
10 * WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * General Public License for more details.
14 * You should have received a copy of the GNU General Public License along
15 * with this program; if not, write to the Free Software Foundation, Inc.,
16 * 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
19 * Richard W.M. Jones <rjones@redhat.com>
25 #include "configfile.h"
26 #include "utils_ignorelist.h"
27 #include "utils_complain.h"
29 #include <libvirt/libvirt.h>
30 #include <libvirt/virterror.h>
31 #include <libxml/parser.h>
32 #include <libxml/tree.h>
33 #include <libxml/xpath.h>
35 static const char *config_keys[] = {
49 #define NR_CONFIG_KEYS ((sizeof config_keys / sizeof config_keys[0]) - 1)
52 static virConnectPtr conn = 0;
53 static char *conn_string = NULL;
54 static c_complain_t conn_complain = C_COMPLAIN_INIT_STATIC;
56 /* Seconds between list refreshes, 0 disables completely. */
57 static int interval = 60;
59 /* List of domains, if specified. */
60 static ignorelist_t *il_domains = NULL;
61 /* List of block devices, if specified. */
62 static ignorelist_t *il_block_devices = NULL;
63 /* List of network interface devices, if specified. */
64 static ignorelist_t *il_interface_devices = NULL;
66 static int ignore_device_match (ignorelist_t *,
67 const char *domname, const char *devpath);
69 /* Actual list of domains found on last refresh. */
70 static virDomainPtr *domains = NULL;
71 static int nr_domains = 0;
73 static void free_domains (void);
74 static int add_domain (virDomainPtr dom);
76 /* Actual list of block devices found on last refresh. */
78 virDomainPtr dom; /* domain */
79 char *path; /* name of block device */
82 static struct block_device *block_devices = NULL;
83 static int nr_block_devices = 0;
85 static void free_block_devices (void);
86 static int add_block_device (virDomainPtr dom, const char *path);
88 /* Actual list of network interfaces found on last refresh. */
89 struct interface_device {
90 virDomainPtr dom; /* domain */
91 char *path; /* name of interface device */
94 static struct interface_device *interface_devices = NULL;
95 static int nr_interface_devices = 0;
97 static void free_interface_devices (void);
98 static int add_interface_device (virDomainPtr dom, const char *path);
100 /* HostnameFormat. */
101 #define HF_MAX_FIELDS 3
110 static enum hf_field hostname_format[HF_MAX_FIELDS] =
113 /* Time that we last refreshed. */
114 static time_t last_refresh = (time_t) 0;
116 static int refresh_lists (void);
118 /* Submit functions. */
119 static void cpu_submit (unsigned long long cpu_time,
121 virDomainPtr dom, const char *type);
122 static void vcpu_submit (unsigned long long cpu_time,
124 virDomainPtr dom, int vcpu_nr, const char *type);
125 static void submit_counter2 (const char *type, counter_t v0, counter_t v1,
127 virDomainPtr dom, const char *devname);
129 /* ERROR(...) macro for virterrors. */
130 #define VIRT_ERROR(conn,s) do { \
132 err = (conn) ? virConnGetLastError ((conn)) : virGetLastError (); \
133 if (err) ERROR ("%s: %s", (s), err->message); \
139 if (virInitialize () != 0)
146 lv_config (const char *key, const char *value)
148 if (virInitialize () != 0)
151 if (il_domains == NULL)
152 il_domains = ignorelist_create (1);
153 if (il_block_devices == NULL)
154 il_block_devices = ignorelist_create (1);
155 if (il_interface_devices == NULL)
156 il_interface_devices = ignorelist_create (1);
158 if (strcasecmp (key, "Connection") == 0) {
159 char *tmp = strdup (value);
161 ERROR ("libvirt plugin: Connection strdup failed.");
169 if (strcasecmp (key, "RefreshInterval") == 0) {
171 interval = strtol (value, &eptr, 10);
172 if (eptr == NULL || *eptr != '\0') return 1;
176 if (strcasecmp (key, "Domain") == 0) {
177 if (ignorelist_add (il_domains, value)) return 1;
180 if (strcasecmp (key, "BlockDevice") == 0) {
181 if (ignorelist_add (il_block_devices, value)) return 1;
184 if (strcasecmp (key, "InterfaceDevice") == 0) {
185 if (ignorelist_add (il_interface_devices, value)) return 1;
189 if (strcasecmp (key, "IgnoreSelected") == 0) {
192 ignorelist_set_invert (il_domains, 0);
193 ignorelist_set_invert (il_block_devices, 0);
194 ignorelist_set_invert (il_interface_devices, 0);
198 ignorelist_set_invert (il_domains, 1);
199 ignorelist_set_invert (il_block_devices, 1);
200 ignorelist_set_invert (il_interface_devices, 1);
205 if (strcasecmp (key, "HostnameFormat") == 0) {
207 char *fields[HF_MAX_FIELDS];
210 value_copy = strdup (value);
211 if (value_copy == NULL) {
212 ERROR ("libvirt plugin: strdup failed.");
216 n = strsplit (value_copy, fields, HF_MAX_FIELDS);
219 ERROR ("HostnameFormat: no fields");
223 for (i = 0; i < n; ++i) {
224 if (strcasecmp (fields[i], "hostname") == 0)
225 hostname_format[i] = hf_hostname;
226 else if (strcasecmp (fields[i], "name") == 0)
227 hostname_format[i] = hf_name;
228 else if (strcasecmp (fields[i], "uuid") == 0)
229 hostname_format[i] = hf_uuid;
232 ERROR ("unknown HostnameFormat field: %s", fields[i]);
238 for (i = n; i < HF_MAX_FIELDS; ++i)
239 hostname_format[i] = hf_none;
244 /* Unrecognised option. */
255 /* `conn_string == NULL' is acceptable. */
256 conn = virConnectOpenReadOnly (conn_string);
258 c_complain (LOG_ERR, &conn_complain,
259 "libvirt plugin: Unable to connect: "
260 "virConnectOpenReadOnly failed.");
264 c_release (LOG_NOTICE, &conn_complain,
265 "libvirt plugin: Connection established.");
269 /* Need to refresh domain or device lists? */
270 if ((last_refresh == (time_t) 0) ||
271 ((interval > 0) && ((last_refresh + interval) <= t))) {
272 if (refresh_lists () != 0) {
274 virConnectClose (conn);
282 for (i = 0; i < nr_domains; ++i)
283 fprintf (stderr, "domain %s\n", virDomainGetName (domains[i]));
284 for (i = 0; i < nr_block_devices; ++i)
285 fprintf (stderr, "block device %d %s:%s\n",
286 i, virDomainGetName (block_devices[i].dom),
287 block_devices[i].path);
288 for (i = 0; i < nr_interface_devices; ++i)
289 fprintf (stderr, "interface device %d %s:%s\n",
290 i, virDomainGetName (interface_devices[i].dom),
291 interface_devices[i].path);
294 /* Get CPU usage, VCPU usage for each domain. */
295 for (i = 0; i < nr_domains; ++i) {
297 virVcpuInfoPtr vinfo = NULL;
301 status = virDomainGetInfo (domains[i], &info);
304 ERROR ("libvirt plugin: virDomainGetInfo failed with status %i.",
309 if (info.state != VIR_DOMAIN_RUNNING)
311 /* only gather stats for running domains */
315 cpu_submit (info.cpuTime, t, domains[i], "virt_cpu_total");
317 vinfo = malloc (info.nrVirtCpu * sizeof (vinfo[0]));
319 ERROR ("libvirt plugin: malloc failed.");
323 status = virDomainGetVcpus (domains[i], vinfo, info.nrVirtCpu,
324 /* cpu map = */ NULL, /* cpu map length = */ 0);
327 ERROR ("libvirt plugin: virDomainGetVcpus failed with status %i.",
333 for (j = 0; j < info.nrVirtCpu; ++j)
334 vcpu_submit (vinfo[j].cpuTime,
335 t, domains[i], vinfo[j].number, "virt_vcpu");
340 /* Get block device stats for each domain. */
341 for (i = 0; i < nr_block_devices; ++i) {
342 struct _virDomainBlockStats stats;
344 if (virDomainBlockStats (block_devices[i].dom, block_devices[i].path,
345 &stats, sizeof stats) != 0)
348 if ((stats.rd_req != -1) && (stats.wr_req != -1))
349 submit_counter2 ("disk_ops",
350 (counter_t) stats.rd_req, (counter_t) stats.wr_req,
351 t, block_devices[i].dom, block_devices[i].path);
353 if ((stats.rd_bytes != -1) && (stats.wr_bytes != -1))
354 submit_counter2 ("disk_octets",
355 (counter_t) stats.rd_bytes, (counter_t) stats.wr_bytes,
356 t, block_devices[i].dom, block_devices[i].path);
357 } /* for (nr_block_devices) */
359 /* Get interface stats for each domain. */
360 for (i = 0; i < nr_interface_devices; ++i) {
361 struct _virDomainInterfaceStats stats;
363 if (virDomainInterfaceStats (interface_devices[i].dom,
364 interface_devices[i].path,
365 &stats, sizeof stats) != 0)
368 if ((stats.rx_bytes != -1) && (stats.tx_bytes != -1))
369 submit_counter2 ("if_octets",
370 (counter_t) stats.rx_bytes, (counter_t) stats.tx_bytes,
371 t, interface_devices[i].dom, interface_devices[i].path);
373 if ((stats.rx_packets != -1) && (stats.tx_packets != -1))
374 submit_counter2 ("if_packets",
375 (counter_t) stats.rx_packets, (counter_t) stats.tx_packets,
376 t, interface_devices[i].dom, interface_devices[i].path);
378 if ((stats.rx_errs != -1) && (stats.tx_errs != -1))
379 submit_counter2 ("if_errors",
380 (counter_t) stats.rx_errs, (counter_t) stats.tx_errs,
381 t, interface_devices[i].dom, interface_devices[i].path);
383 if ((stats.rx_drop != -1) && (stats.tx_drop != -1))
384 submit_counter2 ("if_dropped",
385 (counter_t) stats.rx_drop, (counter_t) stats.tx_drop,
386 t, interface_devices[i].dom, interface_devices[i].path);
387 } /* for (nr_interface_devices) */
397 n = virConnectNumOfDomains (conn);
399 VIRT_ERROR (conn, "reading number of domains");
407 /* Get list of domains. */
408 domids = malloc (sizeof (int) * n);
410 ERROR ("libvirt plugin: malloc failed.");
414 n = virConnectListDomains (conn, domids, n);
416 VIRT_ERROR (conn, "reading list of domains");
421 free_block_devices ();
422 free_interface_devices ();
425 /* Fetch each domain and add it to the list, unless ignore. */
426 for (i = 0; i < n; ++i) {
427 virDomainPtr dom = NULL;
430 xmlDocPtr xml_doc = NULL;
431 xmlXPathContextPtr xpath_ctx = NULL;
432 xmlXPathObjectPtr xpath_obj = NULL;
435 dom = virDomainLookupByID (conn, domids[i]);
437 VIRT_ERROR (conn, "virDomainLookupByID");
438 /* Could be that the domain went away -- ignore it anyway. */
442 name = virDomainGetName (dom);
444 VIRT_ERROR (conn, "virDomainGetName");
448 if (il_domains && ignorelist_match (il_domains, name) != 0)
451 if (add_domain (dom) < 0) {
452 ERROR ("libvirt plugin: malloc failed.");
456 /* Get a list of devices for this domain. */
457 xml = virDomainGetXMLDesc (dom, 0);
459 VIRT_ERROR (conn, "virDomainGetXMLDesc");
463 /* Yuck, XML. Parse out the devices. */
464 xml_doc = xmlReadDoc ((xmlChar *) xml, NULL, NULL, XML_PARSE_NONET);
465 if (xml_doc == NULL) {
466 VIRT_ERROR (conn, "xmlReadDoc");
470 xpath_ctx = xmlXPathNewContext (xml_doc);
473 xpath_obj = xmlXPathEval
474 ((xmlChar *) "/domain/devices/disk/target[@dev]",
476 if (xpath_obj == NULL || xpath_obj->type != XPATH_NODESET ||
477 xpath_obj->nodesetval == NULL)
480 for (j = 0; j < xpath_obj->nodesetval->nodeNr; ++j) {
484 node = xpath_obj->nodesetval->nodeTab[j];
486 path = (char *) xmlGetProp (node, (xmlChar *) "dev");
489 if (il_block_devices &&
490 ignore_device_match (il_block_devices, name, path) != 0)
493 add_block_device (dom, path);
495 if (path) xmlFree (path);
497 xmlXPathFreeObject (xpath_obj);
499 /* Network interfaces. */
500 xpath_obj = xmlXPathEval
501 ((xmlChar *) "/domain/devices/interface/target[@dev]",
503 if (xpath_obj == NULL || xpath_obj->type != XPATH_NODESET ||
504 xpath_obj->nodesetval == NULL)
507 for (j = 0; j < xpath_obj->nodesetval->nodeNr; ++j) {
511 node = xpath_obj->nodesetval->nodeTab[j];
513 path = (char *) xmlGetProp (node, (xmlChar *) "dev");
516 if (il_interface_devices &&
517 ignore_device_match (il_interface_devices, name, path) != 0)
520 add_interface_device (dom, path);
522 if (path) xmlFree (path);
526 if (xpath_obj) xmlXPathFreeObject (xpath_obj);
527 if (xpath_ctx) xmlXPathFreeContext (xpath_ctx);
528 if (xml_doc) xmlFreeDoc (xml_doc);
544 for (i = 0; i < nr_domains; ++i)
545 virDomainFree (domains[i]);
553 add_domain (virDomainPtr dom)
555 virDomainPtr *new_ptr;
556 int new_size = sizeof (domains[0]) * (nr_domains+1);
559 new_ptr = realloc (domains, new_size);
561 new_ptr = malloc (new_size);
567 domains[nr_domains] = dom;
572 free_block_devices ()
577 for (i = 0; i < nr_block_devices; ++i)
578 free (block_devices[i].path);
579 free (block_devices);
581 block_devices = NULL;
582 nr_block_devices = 0;
586 add_block_device (virDomainPtr dom, const char *path)
588 struct block_device *new_ptr;
589 int new_size = sizeof (block_devices[0]) * (nr_block_devices+1);
592 path_copy = strdup (path);
597 new_ptr = realloc (block_devices, new_size);
599 new_ptr = malloc (new_size);
601 if (new_ptr == NULL) {
605 block_devices = new_ptr;
606 block_devices[nr_block_devices].dom = dom;
607 block_devices[nr_block_devices].path = path_copy;
608 return nr_block_devices++;
612 free_interface_devices ()
616 if (interface_devices) {
617 for (i = 0; i < nr_interface_devices; ++i)
618 free (interface_devices[i].path);
619 free (interface_devices);
621 interface_devices = NULL;
622 nr_interface_devices = 0;
626 add_interface_device (virDomainPtr dom, const char *path)
628 struct interface_device *new_ptr;
629 int new_size = sizeof (interface_devices[0]) * (nr_interface_devices+1);
632 path_copy = strdup (path);
633 if (!path_copy) return -1;
635 if (interface_devices)
636 new_ptr = realloc (interface_devices, new_size);
638 new_ptr = malloc (new_size);
640 if (new_ptr == NULL) {
644 interface_devices = new_ptr;
645 interface_devices[nr_interface_devices].dom = dom;
646 interface_devices[nr_interface_devices].path = path_copy;
647 return nr_interface_devices++;
651 ignore_device_match (ignorelist_t *il, const char *domname, const char *devpath)
656 n = sizeof (char) * (strlen (domname) + strlen (devpath) + 2);
659 ERROR ("libvirt plugin: malloc failed.");
662 ssnprintf (name, n, "%s:%s", domname, devpath);
663 r = ignorelist_match (il, name);
669 init_value_list (value_list_t *vl, time_t t, virDomainPtr dom)
673 char uuid[VIR_UUID_STRING_BUFLEN];
676 vl->interval = interval_g;
678 sstrncpy (vl->plugin, "libvirt", sizeof (vl->plugin));
682 /* Construct the hostname field according to HostnameFormat. */
683 for (i = 0; i < HF_MAX_FIELDS; ++i) {
684 if (hostname_format[i] == hf_none)
687 n = DATA_MAX_NAME_LEN - strlen (vl->host) - 2;
689 if (i > 0 && n >= 1) {
690 strncat (vl->host, ":", 1);
694 switch (hostname_format[i]) {
697 strncat (vl->host, hostname_g, n);
700 name = virDomainGetName (dom);
702 strncat (vl->host, name, n);
705 if (virDomainGetUUIDString (dom, uuid) == 0)
706 strncat (vl->host, uuid, n);
711 vl->host[sizeof (vl->host) - 1] = '\0';
712 } /* void init_value_list */
715 cpu_submit (unsigned long long cpu_time,
717 virDomainPtr dom, const char *type)
720 value_list_t vl = VALUE_LIST_INIT;
722 init_value_list (&vl, t, dom);
724 values[0].counter = cpu_time;
729 sstrncpy (vl.type, type, sizeof (vl.type));
731 plugin_dispatch_values (&vl);
735 vcpu_submit (counter_t cpu_time,
737 virDomainPtr dom, int vcpu_nr, const char *type)
740 value_list_t vl = VALUE_LIST_INIT;
742 init_value_list (&vl, t, dom);
744 values[0].counter = cpu_time;
748 sstrncpy (vl.type, type, sizeof (vl.type));
749 ssnprintf (vl.type_instance, sizeof (vl.type_instance), "%d", vcpu_nr);
751 plugin_dispatch_values (&vl);
755 submit_counter2 (const char *type, counter_t v0, counter_t v1,
757 virDomainPtr dom, const char *devname)
760 value_list_t vl = VALUE_LIST_INIT;
762 init_value_list (&vl, t, dom);
764 values[0].counter = v0;
765 values[1].counter = v1;
769 sstrncpy (vl.type, type, sizeof (vl.type));
770 sstrncpy (vl.type_instance, devname, sizeof (vl.type_instance));
772 plugin_dispatch_values (&vl);
773 } /* void submit_counter2 */
778 free_block_devices ();
779 free_interface_devices ();
783 virConnectClose (conn);
786 ignorelist_free (il_domains);
788 ignorelist_free (il_block_devices);
789 il_block_devices = NULL;
790 ignorelist_free (il_interface_devices);
791 il_interface_devices = NULL;
797 module_register (void)
799 plugin_register_config ("libvirt",
801 config_keys, NR_CONFIG_KEYS);
802 plugin_register_init ("libvirt", lv_init);
803 plugin_register_read ("libvirt", lv_read);
804 plugin_register_shutdown ("libvirt", lv_shutdown);
808 * vim: shiftwidth=4 tabstop=8 softtabstop=4 expandtab fdm=marker