https://github.com/kumina/libvirt_exporter

Prometheus metrics exporter for libvirt.
https://github.com/kumina/libvirt_exporter

Last synced: 4 days ago
JSON representation

Prometheus metrics exporter for libvirt.

• Host: GitHub
• URL: https://github.com/kumina/libvirt_exporter
• Owner: kumina
• License: apache-2.0
• Archived: true
• Created: 2017-04-11T08:19:51.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2021-03-12T09:24:48.000Z (over 3 years ago)
• Last Synced: 2024-08-02T20:47:11.508Z (3 months ago)
• Language: Go
• Size: 31.3 KB
• Stars: 130
• Watchers: 15
• Forks: 81
• Open Issues: 12
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Prometheus libvirt exporter

**Please note:** This repository is currently unmaintained. Due to insufficient time and not using the exporter anymore

we decided to archive this project.

---

This repository provides code for a Prometheus metrics exporter

for [libvirt](https://libvirt.org/). This exporter connects to any

libvirt daemon and exports per-domain metrics related to CPU, memory,

disk and network usage. By default, this exporter listens on TCP port

9177.

This exporter makes use of

[libvirt-go](https://github.com/libvirt/libvirt-go), the official Go

bindings for libvirt. Ideally, this exporter should make use of the

`GetAllDomainStats()` API call to extract all relevant metrics.

Unfortunately, we at Kumina still need this exporter to be compatible

with older versions of libvirt that don't support this API call.

The following metrics/labels are being exported:

```

libvirt_domain_block_stats_read_bytes_total{domain="...",uuid="...",source_file="...",target_device="..."}

libvirt_domain_block_stats_read_requests_total{domain="...",uuid="...",source_file="...",target_device="..."}

libvirt_domain_block_stats_write_bytes_total{domain="...",uuid="...",source_file="...",target_device="..."}

libvirt_domain_block_stats_write_requests_total{domain="...",uuid="...",source_file="...",target_device="..."}

libvirt_domain_info_cpu_time_seconds_total{domain="...",uuid="..."}

libvirt_domain_info_maximum_memory_bytes{domain="...",uuid="..."}

libvirt_domain_info_memory_usage_bytes{domain="...",uuid="..."}

libvirt_domain_info_virtual_cpus{domain="...",uuid="..."}

libvirt_domain_interface_stats_receive_bytes_total{domain="...",uuid="...",source_bridge="...",target_device="..."}

libvirt_domain_interface_stats_receive_drops_total{domain="...",uuid="...",source_bridge="...",target_device="..."}

libvirt_domain_interface_stats_receive_errors_total{domain="...",uuid="...",source_bridge="...",target_device="..."}

libvirt_domain_interface_stats_receive_packets_total{domain="...",uuid="...",source_bridge="...",target_device="..."}

libvirt_domain_interface_stats_transmit_bytes_total{domain="...",uuid="...",source_bridge="...",target_device="..."}

libvirt_domain_interface_stats_transmit_drops_total{domain="...",uuid="...",source_bridge="...",target_device="..."}

libvirt_domain_interface_stats_transmit_errors_total{domain="...",uuid="...",source_bridge="...",target_device="..."}

libvirt_domain_interface_stats_transmit_packets_total{domain="...",uuid="...",source_bridge="...",target_device="..."}

libvirt_up

```

With the `--libvirt.export-nova-metadata` flag, it will export the following additional OpenStack-specific labels for every domain:

- name

- flavor

- project_name

At Kumina we want to perform a single build of this exporter, deploying

it to a variety of Linux distribution versions. This is why this

repository contains a shell script, `build_static.sh`, that builds a

statically linked copy of this exporter in an Alpine Linux based

container.