Grafana Ceph Dashboard & Prometheus Integration

From OSNEXUS Online Documentation Site
Jump to: navigation, search


Installing Prometheus, Node Exporter and Enabling Ceph Prometheus Module on Focal

1. Configure your Ceph Cluster using QuantaStor version 6.1 for Focal. Ensure Grafana is installed.

Run the following script to install Prometheus and dependencies. This script will also enable Ceph Prometheus Module.

2. Running the installer. Enter the following command from a console on one of your Ceph nodes.

install-ceph-prometheus

You have now successfully installed Prometheus, Node Exporter and Enabled Ceph Prometheus Module

Let us begin the grafana setup now

1. Login to Grafana (http://Your Server IP or Host Name:3000) with default username and password as admin. Click in the 'Toggle Menu' option in the upper left hand side of Grafana to see the menu system.

2. Hover the mouse over the Gear icon and click the ‘data sources’ menu item to add a new Prometheus data source. If the Gear icon is no longer present in your version, then click the 'Add your first data source tile' on the home page.

Graphical user interface, text  Description automatically generated

3. Click ‘Add data source’ and Select Prometheus

A screenshot of a computer screen  Description automatically generated

Ceph-prom-03.PNG


4. Enter URL of Prometheus (node that you ran the 'install-ceph-prometheus' on) and set the HTTP Timeout to 60 and the Scrape Interval to 15s. Click Save & Test.

For example, http://10.0.16.60:9090. Note: those dimmed grayed-out default on this page are Grafana’s default suggestions and not actual values, you must enter in a value. Values will be shown in a white font.

Ceph-prom-04.PNG

After clicking Save & Test you should see the status:

Graphical user interface, text, application  Description automatically generated


5. Hover the mouse over the Dashboards icon, and click on the Import menu item. If the Import menu item is no longer present in the version of Grafana you are using, then click Dashboards in the left-side menu, click New and select Import in the dropdown menu. Enter 7056 in the the 'Import via grafana.com' edit box, click Load.. Enter the Ceph cluster Grafana dashboard id "7056" in the ‘Import via Grafana.com’ field and click Load.

Ceph-prom-06.PNG

Ceph-prom-07.PNG

6. Optionally change the Name field and select the Ceph Prometheus data source you just added in the previous step.

Graphical user interface, text, application  Description automatically generated

Finally, we have successfully integrated our Ceph Cluster with Prometheus, Node Exporter and Grafana!

Ceph-prom-09.PNG

Ceph Cluster #7056

Using this setup process, you can now monitor your Ceph cluster and import other similar Grafana dashboards.

Other Ceph Dashboards tested that work following the same import process:

Graphical user interface

CephFS #9340

Graphical user interface

Ceph - OSD (Single) #5336

A screenshot of a computer

Ceph Pools #5342

References and Credits


1. Prometheus Module - Ceph Documentation, https://docs.ceph.com/en/quincy/mgr/prometheus/

2. Prometheus’s port registry, https://github.com/prometheus/prometheus/wiki/Default-port-allocations

3. 'Ceph Cluster monitoring using Prometheus and Grafana' by Ajinkya Ingole, https://dev.to/ingoleajinkya/ceph-cluster-monitoring-using-prometheus-and-grafana-472i

4. Example script that installs Prom/Grafana/Ceph, https://gist.github.com/kalaspuffar/b0faa4089b7f3920dbafbcedcccbaf16

5. Dashboard Guide - RED HAT CEPH STORAGE 5- Monitoring Ceph Cluster with Ceph Dashboard, https://access.redhat.com/documentation/en-us/red_hat_ceph_storage/5/html-single/dashboard_guide/index#doc-wrapper

6. Prometheus Installation Script for Ubuntu 16.04 and 18.04 LTS, https://github.com/petarnikolovski/prometheus-install

7. Grafana Import a Dashboard Instructions, https://grafana.com/docs/grafana/latest/dashboards/manage-dashboards/#export-and-import-dashboards