For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/en/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/en/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/en/guides/storage-and-backup/block-storage/cloud-disk-array/ceph-check-cluster-status.md.
Skip to content

Cluster status

View as Markdown

This guide shows you how to check your Ceph cluster status and health.

Using the OVHcloud Console


OVHcloud Console Access

  • Direct link:
  • Navigation path: Bare Metal Cloud > Storage > Cloud Disk Array > Select your service

Click the name of your Ceph cluster. The Overview tab shows the General information, Service configuration and Storage tiles.

Cluster details

Additional explanations:

FieldDescription
Alias (General information)Name given to your cluster
Identifier (General information)Identifier (fsid) of your cluster, used as serviceName in the API
Region (General information)We currently deliver Ceph clusters on Strasbourg, Gravelines and Beauharnois.
Creation date (General information)Creation date of your cluster
Last modified date (General information)Date of the last task applied to your cluster
Version (General information)We currently deliver clusters up to version 9.2.1 (official Ceph releases)
Billing status (Service configuration)Active
Crush tunables (Service configuration)It's the algorithm used to place datas.
Monitors (Service configuration)IP that you have to use to reach your monitors.

The Storage tile shows the Total size, Used space and Available space of the cluster. Operations in progress on the cluster are listed in the Activities tab.

Cluster health

The health of the cluster is shown in the Service configuration tile.

Additional explanations:

FieldDescription
HealthOK (HEALTH_OK) means that every object is at the right place and have 3 replicates. HEALTH_WARN means that some objects are misplaced (like after a growth) or that some object are not replicated three times. In this case cluster is recovering
Healthy clusterYes or No, indicating if everything is ok with Ceph cluster or not
Available bytesFree bytes available in the cluster (before replication)
Used bytesBytes currently used in the cluster (after replication)
Space usage [%]Percentage of used bytes in relation to total bytes
Cluster active tasksList of user-initiated tasks that are currently being processed for this cluster

Using API

Get Ceph cluster details with a simple HTTP call.

GET/dedicated/ceph/{serviceName}

Example:

GET /dedicated/ceph/98d166d8-7c88-47b7-9cb6-63acd5a59c15
{
  updateDate: "2016-07-26T09:16:07"
  status: "INSTALLED"
  region: "SBG1"
  serviceName: "98d166d8-7c88-47b7-9cb6-63acd5a59c15"
  state: "ACTIVE"
  createDate: "2016-07-20T08:00:37"
  cephMons: [
    "10.99.187.210"
    "10.99.191.210"
    "10.97.131.210"
  ]
  crushTunables: "OPTIMAL"
  label: "Ceph cluster"
  cephVersion: "9.2.1"
}

Get Ceph cluster health:

GET/dedicated/ceph/{serviceName}/health
{
  status: "HEALTH_OK"
  availableBytes: 5891996504064
  serviceName: "98d166d8-7c88-47b7-9cb6-63acd5a59c15"
  healthy: true
  usedBytes: 124981248
}

Go further

Visit our dedicated Discord channel: https://discord.gg/ovhcloud. Ask questions, provide feedback and interact directly with the team that builds our Storage and Backup services.

For training or technical assistance implementing our solutions, contact your sales representative or visit our Professional Services page to request a quote and have your project analysed by our experts.

Join our community of users.

Was this page helpful?