README

Changelog
=========

v1.3.3: Tweak README: requires ganglia headers > 3.3.1
v1.3.2: Adapt to use gm_file.h instead of local copies of Ganglia
        helper functions (requires ganglia headers > 3.3.2)
v1.3.1: Tweak to build without a local copy of the full Ganglia source tree
v1.3.0: add filesystem capacity metrics
v1.2.0: improve multiCPU metric performance
v1.1.0: rename metric names for IO to follow ganglia-modules-solaris
        conventions and units
v1.0.0: initial release with IO module code developed by JB Kim and
        multiCPU code contributed to Ganglia by Brad Nicholes

Updated metric names and units
==============================

v1.0.0:
- metric names follow the original naming convention for mod_iostat
- values reported are in KB not Bytes, so you might see `K' twice in the
  rrd graph (and if you see K twice, it means you are looking at MBytes)

v1.1.0:
- metric names follow the convention of ganglia-modules-solaris
  (similar to names in kstat, e.g. io_nwrite = number of bytes written)
- values reported in unscaled units (bytes and seconds) rather than
  in KB and milliseconds

modmulticpu
===========

This version of modmulticpu is based on the original module contributed
by Brad Nicholes to the main Ganglia tree.

It has been enhanced to access the array of CPU data in a more efficient
manner.

Building (if using code from git)
=================================

Prepare the tree with this command:

  mkdir m4 && autoreconf --install

Then follow the steps below to build.

Building
========

Sample configure command for building the modules:

  ./configure \
    CFLAGS="`apr-1-config --cflags --includes`" \
    --enable-shared --disable-static

  make