Munin-influxdb

Munin to InfluxDB+Grafana gateway

Tool to migrate smoothly from Munin (RRD) to InfluxDB and Grafana dashboards.

Contains (err, will contain) two parts:

• import
  • Import existing Munin data to InfluxDB (groups fields in the same series by default). Status: done
  • Generate a Grafana dashboard based on the existing Munin configuration. Status: done
• fetch
  • Update InfluxDB with fresh data from a still running Munin service: Status: done
  • Run Munin's plugins but export to InfluxDB instead. Status: not started

InfluxDB storage

Data from Munin RRD databases are combined and imported into an InfluxDB cluster.

Munin fields from a same plugin are grouped as columns of the same InfluxDB time series.

Grafana dashboard

Grafana layout settings are imported from Munin plugin's configuration. Supported elements:

• Min, max, average and current values in legend table
• Line, area, stacked metrics
• Warning, critical thresholds
• Graph orders
• Aliases
• Tooltip overlays
• Metrics colors
• Multigraphs (partial support)

Installation

Very simple!

1. Clone the repository:

   $ git clone https://github.com/mvonthron/munin-influxdb.git
   

2. Install as any Python package:

$ sudo python setup.py install

3. Run import command:

$ sudo ./muninflux import

4. A cron job will be automatically added after installation to refresh data from munin every 5 minutes (Munin default)

Licensing

This program and its documentation are released under the terms of the BSD license.

---

2014, Manuel Vonthron manuel.vonthron@acadis.org