Prometheus exporter that scrapes meta information about a ceph cluster
Go to file
Vaibhav Bhembre ee5251858d Merge pull request #2 from digitalocean/integrate_travis_ci
Integrate Travis, Godoc
2016-01-06 15:05:57 -05:00
collectors Add Ceph Exporter 2016-01-06 13:27:16 -05:00
.gitignore Add Ceph Exporter 2016-01-06 13:27:16 -05:00
.travis.yml Add Travis CI hook 2016-01-06 13:40:25 -05:00
CONTRIBUTING.md Add Ceph Exporter 2016-01-06 13:27:16 -05:00
LICENSE Add Ceph Exporter 2016-01-06 13:27:16 -05:00
Makefile Add Ceph Exporter 2016-01-06 13:27:16 -05:00
Makefile.COMMON Add Ceph Exporter 2016-01-06 13:27:16 -05:00
README.md Add Travis, Godoc badge 2016-01-06 14:09:43 -05:00
exporter.go Add Ceph Exporter 2016-01-06 13:27:16 -05:00
sample.png Add Ceph Exporter 2016-01-06 13:27:16 -05:00

README.md

Ceph Exporter GoDoc Build Status

Prometheus exporter that scrapes meta information about a running ceph cluster. All the information gathered from the cluster is done by interacting with the monitors using an appropriate wrapper over rados_mon_command(). Hence, no additional setup is necessary other than having a working ceph cluster.

Dependencies

You should ideally run this exporter from the client that can talk to Ceph. Like any other ceph client it needs the following files to run correctly.

  • ceph.conf containing your ceph configuration.
  • ceph.<user>.keyring in order to authenticate to your cluster.

Ceph exporter will automatically pick those up if they are present in any of the default locations. Otherwise you will need to provide the configuration manually using --ceph.config flag.

We use Ceph's official Golang client to run commands on the cluster.

Flags

Name Description Default
telemetry.addr Host:Port pair to run exporter on *:9190
telemetry.path URL Path for surfacing metrics to prometheus /metrics
ceph.config Path to ceph configuration file ""

Installation

Typical way of installing in Go should work.

go install

A Makefile is provided in case you find a need for it.

Contributing

Please refer to the CONTRIBUTING guide for more information on how to submit your changes to this repository.

Sample view

If you have promdash set up you can generate views like:


Copyright @ 2016 DigitalOcean™ Inc.