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.

CephPerfTestRequest CR perftest specification

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:

KaaSCephOperationRequest CR perftest specification

This section describes the CephPerfTestRequest CR specification. For the procedure workflow, see Create a Ceph performance test request.

Ceph performance test parameters

Parameter

Description

parameters

A list of command arguments for a performance test execution. For all available parameters, see fio documentation.

Note

Performance test results will be saved on a PVC if the test run parameters contain an argument to save to a file. Otherwise, test results will be saved only as Pod logs. For example, for the default fio image, use the --output=/results/<fileName> option to redirect to a file that will be saved on the attached PVC. Configuring a mount point is not supported.

command

Optional. Entrypoint command to run performance test in the container. If the performance image is updated, you may also update the command. By default, equals the image entry point.

image

Container image to use for jobs. By default, vineethac/fio_image. Mirantis recommends using the default fio image as it supports multitude I/O engines. For details, see fio man page.

periodic

Configuration of the performance test runs as periodic jobs. Leave empty if a single run is required. For details, see Ceph performance periodic parameters.

saveResultOnPvc

Option that enables saving of the performance test results on a PVC. Contains the following fields:

  • pvcName - PVC name to use. If not specified, a PVC name for the performance test will be created automatically. Namespace is static and equals rook-ceph.

  • pvcStorageClass - StorageClass to use for PVC. If not specified, the default storage class is used.

  • pvcSize - PVC size, defaults to 10Gi.

  • preserveOnDelete - PVC preservation after removal of the performance test.

Ceph performance periodic parameters

Parameter

Description

schedule

Required. Schedule in base cron format. For example, * * 30 2 \*. The field format follows the Cron schedule syntax.

suspended

Pause CronJob scheduling to prevent performance test execution. Only for future scheduling.

runsToKeep

Number of runs to keep in history. Supported only by keeping old run Pods with their outputs.
Example of CephPerfTestRequest
apiVersion: lcm.mirantis.com/v1alpha1
kind: CephPerfTestRequest
metadata:
  name: test-mosk-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