The Prometheus libvirt exporter utilizes the go-libvirt module from DigitalOcean to establish a pure Golang interface for interacting with libvirt. This exporter is built to collect metrics from virtual machines within libvirt and expose them through an HTTP service and the Prometheus interface.
You can directly download the executable program for the corresponding computer architecture from the "releases" section to run locally and collect virtual machine metrics. Alternatively, you can download the source code and compile it into an executable program for execution. We also provide a Dockerfile for reference, which can package this exporter into an image for easier use.
The metrics provided by the Prometheus libvirt exporter consist of four types: CPU, memory, network, and disk metrics. The table below introduces these metrics from three aspects: metric name, metric meaning, and the corresponding go-libvirt interface. This information is provided to facilitate both a convenient and in-depth understanding of the specific meanings of these metrics.
| Metrics Name | Metrics Meaning | Go-libvirt Interface |
|---|---|---|
| libvirt_domain_cpu_seconds_total | Total CPU time spent in seconds | DomainGetInfo |
| libvirt_domain_cpu_vcpu_number | Virtual CPU number | DomainGetInfo |
| libvirt_domain_memory_stat_swapIn_bytes | Memory swap in bytes | DomainMemoryStats |
| libvirt_domain_memory_stat_swapOut_bytes | Memory swap out bytes | DomainMemoryStats |
| libvirt_domain_memory_stat_major_fault_pages | Memory major fault pages | DomainMemoryStats |
| libvirt_domain_memory_stat_minor_fault_pages | Memory minor fault pages | DomainMemoryStats |
| libvirt_domain_memory_stat_unused_bytes | Memory unused bytes | DomainMemoryStats |
| libvirt_domain_memory_stat_available_bytes | Memory available bytes | DomainMemoryStats |
| libvirt_domain_memory_stat_actual_balloon_bytes | Memory actual balloon bytes | DomainMemoryStats |
| libvirt_domain_memory_stat_rss_bytes | Memory rss bytes | DomainMemoryStats |
| libvirt_domain_memory_stat_usable_bytes | Memory usable bytes | DomainMemoryStats |
| libvirt_domain_memory_stat_last_update_timestamp | Memory last update timestamp | DomainMemoryStats |
| libvirt_domain_memory_stat_disk_cache_bytes | Memory disk cache bytes | DomainMemoryStats |
| libvirt_domain_memory_stat_hugetlb_alloc_pages | Memory hugetlb alloc pages | DomainMemoryStats |
| libvirt_domain_memory_stat_hugetlb_fail_pages | Memory hugetlb fail pages | DomainMemoryStats |
| libvirt_domain_interface_receive_bytes_total | Total number of bytes received | DomainInterfaceStats |
| libvirt_domain_interface_receive_packets_total | Total number of packets received | DomainInterfaceStats |
| libvirt_domain_interface_receive_errors_total | Total number of errors received | DomainInterfaceStats |
| libvirt_domain_interface_receive_drops_total | Total number of drops received | DomainInterfaceStats |
| libvirt_domain_interface_transmit_bytes_total | Total number of bytes transmitted | DomainInterfaceStats |
| libvirt_domain_interface_transmit_packets_total | Total number of packets transmitted | DomainInterfaceStats |
| libvirt_domain_interface_transmit_errors_total | Total number of errors transmitted | DomainInterfaceStats |
| libvirt_domain_interface_transmit_drops_total | Total number of drops transmitted | DomainInterfaceStats |
| libvirt_domain_block_read_bytes_total | Total number of bytes read | DomainBlockStats |
| libvirt_domain_block_read_requests_total | Total number of requests read | DomainBlockStats |
| libvirt_domain_block_write_bytes_total | Total number of bytes written | DomainBlockStats |
| libvirt_domain_block_write_requests_total | Total number of requests written | DomainBlockStats |
| libvirt_domain_block_capacity_bytes | Total number of capacity bytes | DomainGetBlockInfo |
| libvirt_domain_block_allocation_bytes | Total number of allocation bytes | DomainGetBlockInfo |
| libvirt_domain_block_physical_bytes | Total number of physical bytes | DomainGetBlockInfo |