---
title: "Measure the random IOPS of the replication-manager host's storage with sysbench"
method: POST
path: "/api/clusters/settings/actions/calibrate-iops"
tags: ["GlobalSetting"]
---

# Measure the random IOPS of the replication-manager host's storage with sysbench

`POST /api/clusters/settings/actions/calibrate-iops`

## Request

- The document declares no server URL.
- Auth: none declared. Required headers: `Authorization`

Runs the embedded sysbench fileio (2G of files, 16 KiB random read/write, direct IO, 16 threads, 20 s) in the working directory at the lowest CPU priority, then removes the files. Answers the host IOPS and that figure times the agents and, with apply=true, writes the latter to resource-manager-infra-iops. Representative when every node has the same storage.

## Query parameters

- `apply` boolean

## Headers

- `Authorization` string, required

## Response `200`

OK

- ServerIOPSCalibration
  - `agents` integer
  - `applied` boolean
  - `dir` string
  - `durationSecond` integer
  - `hostIops` number
  - `infraIops` number
  - `message` string
  - `readsPerSecond` number
  - `writesPerSecond` number

## Other responses

- `403`: No valid ACL
- `409`: An IOPS calibration is already running

## Changes

- **2026-10-12** `d4e4c5013f0c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/signal18/apis/signal-18-dashboard-api/changes/api/clusters/settings/actions/calibrate-iops/post.md)

---

[API](https://skmtc.dev/signal18/apis/signal-18-dashboard-api.md) - [All operations](https://skmtc.dev/signal18/apis/signal-18-dashboard-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signal18/apis/signal-18-dashboard-api/revisions/8ee8a1e31294?raw)