XorMon, open source under GPL v3, monitors Ceph storage by reading the Prometheus module of the Ceph manager on port 9283, HTTP by default and HTTPS supported. It graphs IO and data per pool, volume and OSD, latency per volume and OSD, adds RGW, MDS and BlueStore metrics, and shows Ceph health checks with alerting.

How does XorMon collect Ceph monitoring data?

XorMon reads the Prometheus export module of the Ceph manager, which listens on port 9283: HTTP by default, HTTPS supported.

XorMon is pointed at the Ceph manager nodes that can host the Prometheus module, or at a single load balanced hostname that leads to the active manager. Red Hat Ceph Storage, IBM Storage Ceph and Lenovo Ceph Storage Solutions are monitored the same way.

Sources: installation steps below, updated 2026-11-07, Red Hat Ceph monitoring, updated 2026-11-06, IBM storage monitoring, updated 2026-11-03, Ceph health monitoring, updated 2026-08-03, and Lenovo storage monitoring, updated 2026-11-06.

Does XorMon use a Ceph Prometheus exporter or ceph-exporter?

XorMon reads the Prometheus export module of the Ceph manager. That module does not export Ceph daemon perf counters by default, so the installation page turns them on.

Pool metrics come from the same module once pool statistics are enabled for selected pools or all pools.

Sources: installation steps below, updated 2026-11-07.

Which Ceph metrics does XorMon collect?

XorMon graphs capacity, IO, data throughput and placement groups per pool, IO, data and latency per volume, and IO, data, latency and capacity per OSD.

The Ceph tab of the feature matrix also lists cache, get, put and request for RGW, request, latency, directory and inode for MDS, and BlueStore and RocksDB for the backend. CFG Tracker records Ceph configuration changes such as the device IP address, OSD hostnames and RGW hostnames. Storage data is kept from 5 minute averages for 3 months up to daily averages for 3 years.

Sources: Feature matrix, Ceph tab, CFG Tracker, updated 2026-10-19, and Data retention, updated 2026-05-04.

How does XorMon alert on Ceph health problems?

The XorMon Health Status page shows the active Ceph health checks and errored cephadm daemons, and a default baseline of critical checks drives the device status. Event alerting sends an alert when a device goes red in the global health status dashboard.

The default baseline has eight critical checks, among them OSD_DOWN, OSD_FULL, POOL_FULL, PG_DAMAGED and MON_DOWN, and the settings of each Ceph device can add, remove or replace checks. Performance alerts can use any metric that XorMon collects, such as latency, with a threshold. When a device turns green again, a clear alert is sent.

Sources: Ceph health monitoring, updated 2026-08-03, and Alerting, updated 2026-10-13.

Key points

• Reads the Prometheus module of the Ceph manager, on port 9283 (HTTP by default, HTTPS supported).
• Daemon perf counters and pool metrics are options of that same module.
• Pools, volumes and OSDs, plus RGW, MDS, BlueStore and RocksDB metrics.
• Health Status page with a default baseline of eight Ceph health checks, adjustable per device.
• Performance and HW event alerts, free open source license (GPL v3).

Installation and configuration for Ceph

XorMon collects data from Prometheus export module.
Ceph version 14.2 (Nautilus) and newer are supported.

For how health checks affect device status and optional per-device tuning, see Ceph health monitoring.

Enable Prometheus export module

Prometheus online docu


ceph mgr module enable prometheus

Enable Pool metrics
Selected pools

ceph config set mgr mgr/prometheus/rbd_stats_pools "pool1,pool2,poolN"

All pools

ceph config set mgr mgr/prometheus/rbd_stats_pools "*"

Enable performance counters in Prometheus
With the introduction of ceph-exporter daemon, the Prometheus module will no longer export Ceph daemon perf counters as prometheus metrics by default.
However, one may re-enable exporting these metrics by setting the module option exclude_perf_counters to false:

ceph config set mgr mgr/prometheus/exclude_perf_counters false

Configure firewall
Enable access to Prometheus export module from XorMon.
By default module accepts HTTP requests on port 9283.

XorMon storage configuration

• Configure hostnames/IPs
  If you are using a load balancer translating hostname to an active manager node, then you can fill in only the load balanced hostname.
  Otherwise, fill in IP addresses/hostnames of all CEPH manager nodes which can host the Prometheus module.
  You cen get a list of manager nodes from "ceph -s" command.
  
  
• Add storage into configuration from the UI:
  XorMon UI ➡ Settings icon ➡ Device ➡ Storage ➡ New ➡ Vendor:device ➡ Ceph
  
• Run "Test" for configured storage device, it must show "OK"
  
  
• Wait about 1 hour, then reload the web browser, you should see it in XorMon UI
  
  

Other storage systems are covered as well: see storage monitoring in XorMon.

Dernière mise à jour : 2026-11-07