one-graphite

CronJob to gather metrics out of OpenNebula and send them to Graphite

This script is a simple tool to gather some useful informations
out of OpenNebula by calling the known OpenNebula utilities and parse their XML outputs. The primary goal is to build a solution for long-term statistics and capacity management. It is not a replacement, but a addon, for common system management and monitoring (!).

Platform requirements

The script was developed to work with OpenNebula (4.14).

Software requirements

• GNU/Linux OS
• Cron
• Ruby
• Gem: "nokogiri" (for XML operations)
• Gem: "simple-graphite" (to push metrics to Graphite)

How does it work?

The ruby script "one-graphite.rb" is beeing executed on the OpenNebula Host running oned every 5 Minutes by Cronjob. The script calls known commands like "onehost -x" or "onegroup -x" and parses the XML output for the wanted information and pushed them to Graphite. The informations stored in Graphite could be uses for building Dashboards and Graphs for long-term statistics and operations (f.e. Big Screen/TV with your Cloud-Dashboard).

Some exported Grafana Dashboard definitions are included as importable JSON files.

Preparation

Before the script sends the first metrics to graphite you have to create the storage schema in Graphite. We use the following definition:

[opennebula]
pattern = ^opennebula-performance.*
retentions = 5m:100d,10m:1y,30m:5y#

Installation

• Move the small script to your desired location like /usr/local/bin/

• Create a Cronjob which executes the script every 5 Minutes ( */5 * * * * /usr/local/bin/one-graphite.rb >/dev/null 2>&1 ) and ensure that the script is excecuteable

• Wait some cycles for the first metrics

• Import the Grafana Dashboard JSON

• Enjoy your OpenNebula Performance Dashboards

Tested environment

• debian GNU/Linux Jessie
• OpenNebula 4.14
• Graphite 0.9.10
• Grafana v2.6.0 (2015-12-14)