uuid plugin¶


Plugin name	`uuid`
Type	other
Callbacks	config, init
Status	supported
Since	4.3
Copyright	2007 Red Hat Inc.
License	GPLv2
Configuration	collectd.conf(5)

The UUID plugin tries hard to determine the UUID (an unique identifier) of the system it is running on, using a file (default: /etc/uuid), freedesktop.org's “Hardware Abstraction Layer” (HAL) if available, dmidecode(8), and another file, this time /sys/hypervisor/uuid.

This plugin has been written to be used in highly virtualized environments, such as compute clouds, where the hostname of guests may not be really unique or may change regularly.

Synopsis¶

 <Plugin "uuid">
   UUIDFile "/etc/uuid"
 </Plugin>

Dependencies¶

libhal (optional)

Configuration¶

Configuration options · from collectd.conf(5)

See this section in the full configuration reference

This plugin, if loaded, causes the Hostname to be taken from the machine's UUID. The UUID is a universally unique designation for the machine, usually taken from the machine's BIOS. This is most useful if the machine is running in a virtual environment such as Xen, in which case the UUID is preserved across shutdowns and migration.

The following methods are used to find the machine's UUID, in order:

Check /etc/uuid (or UUIDFile).
Check for UUID from HAL (http://www.freedesktop.org/wiki/Software/hal) if present.
Check for UUID from dmidecode / SMBIOS.
Check for UUID from Xen hypervisor.

If no UUID can be found then the hostname is not modified.

UUIDFile Path: Take the UUID from the given file (default /etc/uuid).