Ceph-Dash

Monitor your Ceph cluster with a fast, clean and easy to setup dashboard

Download Ceph-dash
Version 1.2 released 09.03.2017

setup

Easy to setup

You can try ceph-dash in a few seconds! It requires no api (since it brings it's own), just Python2, Flask and the Ceph Python bindins. And for sure a running Ceph cluster. See here how you can get it up and running!

setup

Easy to read

Ceph-dash shows you exactly what you need to know on a single web page! You can see at the first glance if something is wrong, and it will show you at the second glance WHAT and WHERE the problem is!

setup

Easy to contribute

Ceph-dash is a small piece of software and written in (hopefully) easily understandable code. I already received lots of contributions and have also seen some forks with custom feature that suit special environments!


Your overall cluster status on one page

Ceph-dash is designed to show you everything you need to know about your ceph cluster health status on one clean page. Is there some recovery going on? Is my cluster in a warning state and if yes why? How many placement groups are in a unclean state? How much traffic is on my cluster right now? You will get all of the information by one quick look on your dashboard!

cephdash

Small dependencies

Ceph-dash only needs Python2 installed together with python-flask and python-ceph. It uses librados directly to talk with the ceph cluster and is not dependant on any other api. Just fire up ./ceph-dash.py and you have everything you need to monitor your ceph cluster!

See where the problem is

Ceph-dash shows you not only THAT something is wrong, it also shows you WHERE the problem is! Is one of your monitors down? Are placementgroups inconsistent? See it at a single glance! Does ceph-dash show you unhealthy OSDs? Hover over the field and see what OSDs on which hosts are making trouble!

cephdash

Use the read-only api

You can use ceph-dash not only as a dashboard, you can also get all the cluster status information as JSON data, calling ceph-dash with Content-Type: application/json! JSON is easily parsable in any programming language, so you can use the information from ceph-dash to automate processes with your own tools in your own infrastructure.

Monitor you cluster with Nagios

I have also provided a Nagios/Icinga Plugin that uses ceph-dash as a monitoring endpoint. You can simply plug it into you monitoring coniguration and get the cluster status and lots of performance data from your cluster without the need of running local processes on your ceph systems! The check can be obtained here and an article about monitoring Ceph with ceph-dash can be found here.

Integrate your graphite data

Ceph-dash uses the awesome D3 Librabry to display graphs for your Graphite data! Anything that you feed into graphite can be integrated into ceph-dash to complete the whole picture of your cluster health even more! We are using the Nagios-Check for ceph-dash to gather performance data, that we then show as graphs in ceph-dash!

cephdash

Deploy it into your favourite webserver

Ceph-dash is a WSGI application, powered by Flask. That means you can deploy it into WSGI-capable webserver, like Apache or Nginx. Sample configuration files for these two webserver are already included into ceph-dash. Make use of it! Since the built-in webserver is single threaded and just for testing, this will improve performance a lot!