Searching for results...

No results

Your search did not match anything from Mirantis documentation.
Check your spelling or try different keywords.

An error occurred

An error occurred while using the search.
Try your search again or contact us to let us know about it.

Newer documentation is now live.You are currently reading an older version.

Create a Ceph performance test request

TechPreview

Warning

This procedure is valid for MOSK clusters that use the MiraCeph custom resource (CR), which is available since MOSK 25.2 to replace the unsupported KaaSCephCluster resource. And MiraCeph will be automatically migrated to CephDeployment in MOSK 26.1. For details, see Deprecation Notes: KaaSCephCluster API on management clusters.

For the equivalent procedure with the unsupported KaaSCephCluster CR, refer to the following section:

Create a Ceph performance test request

Warning

Performance testing affects the overall Ceph cluster performance. Do not run it unless you are sure that user load will not be affected.

This section describes how to create a Ceph performance test request through the CephPerfTestRequest CR.

To create a Ceph performance test request:

  1. Create an RBD image with the required parameters. For example, run the following command in rook-ceph-tools pod to allow execution of the perftest example below on a MOSK cluster:

    kubectl exec -ti -n rook-ceph deploy/rook-ceph-tools -- bash
rbd create <pool_name>/<image_name> --size 10G

    Substitute <pool_name> and <image_name> with pool and image names, and specify the size. In the example below, mirablock-k8s-block-hdd is used as pool name and tests as image name:

    kubectl exec -ti -n rook-ceph deploy/rook-ceph-tools -- bash
rbd create mirablock-k8s-block-hdd/tests --size 10G

  2. Create a YAML template for the CephPerfTestRequest CR. For details, see CephPerfTestRequest CR perftest specification.

    kubectl apply -f <example_file_name>.yaml
    Example of the CephPerfTestRequest resource
    apiVersion: lcm.mirantis.com/v1alpha1
kind: CephPerfTestRequest
metadata:
  name: test-perf-req
  namespace: ceph-lcm-mirantis
spec:
  parameters:
  - --ioengine=rbd
  - --pool=mirablock-k8s-block-hdd
  - --rbdname=tests
  - --name=single_perftest
  - --rw=randrw:16k
  - --rwmixread=40
  - --bs=4k
  - --size=500M
  - --iodepth=32
  - --numjobs=8
  - --group_reporting
  - --direct=1
  - --fsync=32
  - --buffered=0
  - --exitall

  3. Review the CephPerfTestRequest status. For details, see CephPerfTestRequest perftest status.

    kubectl -n ceph-lcm-mirantis get cephperftestrequest test-mosk-req

    Example of system response:

    NAME            AGE     PHASE      START TIME             DURATION   JOB STATUS   SCHEDULE   REFERENCE                        REFERENCE NAMESPACE
test-perf-req   2m25s   Finished   2025-01-16T13:51:00Z   9m15s      Completed               job/test-perf-req-cephperftest   rook-ceph

  4. Review the performance test result by inspecting logs for the corresponding job Pod on the MOSK cluster:

    kubectl -n rook-ceph logs -l app=ceph-perftest,perftest=<name>

    Substitute <name> with the CephPerfTestRequest metadata.name, for example, test-perf-req.

  5. Optional. Remove the CephPerfTestRequest:

    kubectl -n ceph-lcm-mirantis get cephperftestrequest test-mosk-req