c5bec3962d | ||
---|---|---|
collectors | ||
.gitignore | ||
CONTRIBUTING.md | ||
Dockerfile | ||
LICENSE | ||
Makefile | ||
Makefile.COMMON | ||
README.md | ||
exporter.go | ||
sample.png |
README.md
Ceph Exporter
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.