README (1d5efeb) - munin-ceph-status

README

Ceph Cluster status plugin for Munin
====================================

Usage
-----

$0 config
	show graphs that should be generated

$0
	show the data for the graphs

This plugin have 3 modes :

- ceph_usage : graph data/allocated and total space cluster usage
  - ceph_osd : graph ceph OSDs number (total/UP/IN)
  - ceph_mon : graph ceph MONs number (total/UP)

To install this plugin :

ln -s /path/to/ceph_status /etc/munin/plugins/ceph_usage
  ln -s /path/to/ceph_status /etc/munin/plugins/ceph_osd
  ln -s /path/to/ceph_status /etc/munin/plugins/ceph_mon

If you are using cephx, you have to manually configure it :

- You have to create ceph user first :

ceph auth get-or-create client.munin mon 'allow r' > /etc/ceph/ceph.client.munin.keyring
  chown munin: /etc/ceph/ceph.client.munin.keyring
  chmod 400 /etc/ceph/ceph.client.munin.keyring

- After, you have to configure ceph_status execution :

[ceph_*]
      user munin
      env.ceph_id munin
      env.ceph_keyring /etc/ceph/ceph.client.munin.keyring

Author
------

Benjamin Renard <brenard@zionetrix.net>

License
-------

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License version 2
as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.

munin-ceph-status

Fixed s/nagios/munin/ error in documentation