DumbMonit

IntegrationsStorage and backups

Monitor Ceph with DumbMonit

Beta

A Ceph cluster through the REST API of the manager's dashboard: health and its checks, OSDs down or nearly full, placement groups not clean, capacity, pools, monitors out of the quorum.

DocumentationOfficial website: Ceph

Product descriptions are in English, as in the product. The page labels follow your language.

What DumbMonit watches

This integration was built from the Ceph manager dashboard REST API documentation, not against a running cluster yet. It only reads. Tell us what breaks. A Ceph cluster through the REST API of the manager's dashboard module: the health status and the checks behind it, OSDs that are down, out or nearly full, placement groups that are not active+clean, raw capacity, pools and monitors that left the quorum.

Typical use. Storage cluster (beta): health checks, OSDs, placement groups, capacity, pools, monitors

Examples

  • Ceph 18 (Reef)
  • Ceph 19 (Squid)
  • cephadm clusters

How it connects

What you need

  • Dashboard user and passwordThe dumbmonit user of the Ceph dashboard, with the read-only role.

Network ports to open

  • 8443/TCPDashboard REST API (HTTPS, default)
  • 8080/TCPOnly with the HTTP protocol option
Setup steps: Create a read-only dashboard user for DumbMonit
  1. Check that the dashboard is enabled and note the address of the active manager.

    ceph mgr services
  2. Write a long random password to a file, and keep it: DumbMonit needs it.

    openssl rand -base64 24 | tr -d '\n' | tee /tmp/dumbmonit.pwd
  3. Create the user with the built-in read-only role.

    ceph dashboard ac-user-create dumbmonit -i /tmp/dumbmonit.pwd read-only
  4. Delete the password file.

    shred -u /tmp/dumbmonit.pwd
  5. In DumbMonit, enter the address of the active manager (for example ceph.lan) with that user name and password.

Heads-up. A standby manager redirects to the active one: use the address of the active manager. The dashboard ships a self-signed certificate: tick "Accept an unverifiable certificate" unless you installed your own.