On Tue, 07/23 18:29, Benoît Canet wrote: > The thresholds of the leaky bucket algorithm can be used to allow some > burstiness. > > Signed-off-by: Benoit Canet <ben...@irqsave.net> > --- > block/qapi.c | 24 +++++++++++++ > blockdev.c | 105 > +++++++++++++++++++++++++++++++++++++++++++++++------- > hmp.c | 32 +++++++++++++++-- > qapi-schema.json | 34 ++++++++++++++++-- > qemu-options.hx | 2 +- > qmp-commands.hx | 30 ++++++++++++++-- > 6 files changed, 205 insertions(+), 22 deletions(-) > > diff --git a/block/qapi.c b/block/qapi.c > index a4bc411..03f1604 100644 > --- a/block/qapi.c > +++ b/block/qapi.c > @@ -235,6 +235,30 @@ void bdrv_query_info(BlockDriverState *bs, > bs->io_limits.iops[BLOCK_IO_LIMIT_READ]; > info->inserted->iops_wr = > bs->io_limits.iops[BLOCK_IO_LIMIT_WRITE]; > + info->inserted->has_bps_threshold = > + bs->io_limits.bps_threshold[BLOCK_IO_LIMIT_TOTAL]; > + info->inserted->bps_threshold = > + bs->io_limits.bps_threshold[BLOCK_IO_LIMIT_TOTAL]; > + info->inserted->has_bps_rd_threshold = > + bs->io_limits.bps_threshold[BLOCK_IO_LIMIT_READ]; > + info->inserted->bps_rd_threshold = > + bs->io_limits.bps_threshold[BLOCK_IO_LIMIT_READ]; > + info->inserted->has_bps_wr_threshold = > + bs->io_limits.bps_threshold[BLOCK_IO_LIMIT_WRITE]; > + info->inserted->bps_wr_threshold = > + bs->io_limits.bps_threshold[BLOCK_IO_LIMIT_WRITE]; > + info->inserted->has_iops_threshold = > + > bs->io_limits.iops_threshold[BLOCK_IO_LIMIT_TOTAL]; > + info->inserted->iops_threshold = > + > bs->io_limits.iops_threshold[BLOCK_IO_LIMIT_TOTAL]; > + info->inserted->iops_rd_threshold = > + bs->io_limits.iops_threshold[BLOCK_IO_LIMIT_READ]; > + info->inserted->has_iops_rd_threshold = > + bs->io_limits.iops_threshold[BLOCK_IO_LIMIT_READ]; > + info->inserted->has_iops_wr_threshold = > + > bs->io_limits.iops_threshold[BLOCK_IO_LIMIT_WRITE]; > + info->inserted->iops_wr_threshold = > + > bs->io_limits.iops_threshold[BLOCK_IO_LIMIT_WRITE]; > } > > bs0 = bs; > diff --git a/blockdev.c b/blockdev.c > index 491e4d0..241ebe8 100644 > --- a/blockdev.c > +++ b/blockdev.c > @@ -341,6 +341,17 @@ static bool do_check_io_limits(BlockIOLimit *io_limits, > Error **errp) > return false; > } > > + if (io_limits->bps_threshold[BLOCK_IO_LIMIT_TOTAL] < 0 || > + io_limits->bps_threshold[BLOCK_IO_LIMIT_WRITE] < 0 || > + io_limits->bps_threshold[BLOCK_IO_LIMIT_READ] < 0 || > + io_limits->iops_threshold[BLOCK_IO_LIMIT_TOTAL] < 0 || > + io_limits->iops_threshold[BLOCK_IO_LIMIT_WRITE] < 0 || > + io_limits->iops_threshold[BLOCK_IO_LIMIT_READ] < 0) { > + error_setg(errp, > + "threshold values must be 0 or greater"); > + return false; > + } > + > return true; > } > > @@ -523,24 +534,34 @@ DriveInfo *drive_init(QemuOpts *all_opts, > BlockInterfaceType block_default_type) > qemu_opt_get_number(opts, "bps_rd", 0); > io_limits.bps[BLOCK_IO_LIMIT_WRITE] = > qemu_opt_get_number(opts, "bps_wr", 0); > + /* bps thresholds */ > + io_limits.bps_threshold[BLOCK_IO_LIMIT_TOTAL] = > + qemu_opt_get_number(opts, "bps_threshold", > + io_limits.bps[BLOCK_IO_LIMIT_TOTAL] / > THROTTLE_HZ); > + io_limits.bps_threshold[BLOCK_IO_LIMIT_READ] = > + qemu_opt_get_number(opts, "bps_rd_threshold", > + io_limits.bps[BLOCK_IO_LIMIT_READ] / > THROTTLE_HZ); > + io_limits.bps_threshold[BLOCK_IO_LIMIT_WRITE] = > + qemu_opt_get_number(opts, "bps_wr_threshold", > + io_limits.bps[BLOCK_IO_LIMIT_WRITE] / > THROTTLE_HZ); > + > io_limits.iops[BLOCK_IO_LIMIT_TOTAL] = > qemu_opt_get_number(opts, "iops", 0); > io_limits.iops[BLOCK_IO_LIMIT_READ] = > qemu_opt_get_number(opts, "iops_rd", 0); > io_limits.iops[BLOCK_IO_LIMIT_WRITE] = > qemu_opt_get_number(opts, "iops_wr", 0); > - io_limits.bps_threshold[BLOCK_IO_LIMIT_TOTAL] = > - io_limits.bps[BLOCK_IO_LIMIT_TOTAL] / THROTTLE_HZ; > - io_limits.bps_threshold[BLOCK_IO_LIMIT_READ] = > - io_limits.bps[BLOCK_IO_LIMIT_READ] / THROTTLE_HZ; > - io_limits.bps_threshold[BLOCK_IO_LIMIT_WRITE] = > - io_limits.bps[BLOCK_IO_LIMIT_WRITE] / THROTTLE_HZ; > - io_limits.iops_threshold[BLOCK_IO_LIMIT_TOTAL] = > - io_limits.iops[BLOCK_IO_LIMIT_TOTAL] / > THROTTLE_HZ; > + > + /* iops thresholds */ > + io_limits.iops_threshold[BLOCK_IO_LIMIT_TOTAL] = > + qemu_opt_get_number(opts, "iops_threshold", > + io_limits.iops[BLOCK_IO_LIMIT_TOTAL] / > THROTTLE_HZ); > io_limits.iops_threshold[BLOCK_IO_LIMIT_READ] = > - io_limits.iops[BLOCK_IO_LIMIT_READ] / THROTTLE_HZ; > - io_limits.iops_threshold[BLOCK_IO_LIMIT_WRITE] = > - io_limits.iops[BLOCK_IO_LIMIT_WRITE] / > THROTTLE_HZ; > + qemu_opt_get_number(opts, "iops_rd_threshold", > + io_limits.iops[BLOCK_IO_LIMIT_READ] / > THROTTLE_HZ); > + io_limits.iops_threshold[BLOCK_IO_LIMIT_WRITE] = > + qemu_opt_get_number(opts, "iops_wr_threshold", > + io_limits.iops[BLOCK_IO_LIMIT_WRITE] / > THROTTLE_HZ); > > if (!do_check_io_limits(&io_limits, &error)) { > error_report("%s", error_get_pretty(error)); > @@ -1224,8 +1245,22 @@ void qmp_change_blockdev(const char *device, const > char *filename, > > /* throttling disk I/O limits */ > void qmp_block_set_io_throttle(const char *device, int64_t bps, int64_t > bps_rd, > - int64_t bps_wr, int64_t iops, int64_t iops_rd, > - int64_t iops_wr, Error **errp) > + int64_t bps_wr, > + int64_t iops, > + int64_t iops_rd, > + int64_t iops_wr, > + bool has_bps_threshold, > + int64_t bps_threshold, > + bool has_bps_rd_threshold, > + int64_t bps_rd_threshold, > + bool has_bps_wr_threshold, > + int64_t bps_wr_threshold, > + bool has_iops_threshold, > + int64_t iops_threshold, > + bool has_iops_rd_threshold, > + int64_t iops_rd_threshold, > + bool has_iops_wr_threshold, > + int64_t iops_wr_threshold, Error **errp) > { > BlockIOLimit io_limits; > BlockDriverState *bs; > @@ -1249,6 +1284,26 @@ void qmp_block_set_io_throttle(const char *device, > int64_t bps, int64_t bps_rd, > io_limits.iops_threshold[BLOCK_IO_LIMIT_READ] = iops_rd / THROTTLE_HZ; > io_limits.iops_threshold[BLOCK_IO_LIMIT_WRITE] = iops_wr / THROTTLE_HZ; > > + /* override them with givens values if present */ > + if (has_bps_threshold) { > + io_limits.bps_threshold[BLOCK_IO_LIMIT_TOTAL] = bps_threshold; > + } > + if (has_bps_rd_threshold) { > + io_limits.bps_threshold[BLOCK_IO_LIMIT_READ] = bps_rd_threshold; > + } > + if (has_bps_wr_threshold) { > + io_limits.bps_threshold[BLOCK_IO_LIMIT_WRITE] = bps_wr_threshold; > + } > + if (has_iops_threshold) { > + io_limits.iops_threshold[BLOCK_IO_LIMIT_TOTAL] = iops_threshold; > + } > + if (has_iops_rd_threshold) { > + io_limits.iops_threshold[BLOCK_IO_LIMIT_READ] = iops_rd_threshold; > + } > + if (has_iops_wr_threshold) { > + io_limits.iops_threshold[BLOCK_IO_LIMIT_WRITE] = iops_wr_threshold; > + } > + > if (!do_check_io_limits(&io_limits, errp)) { > return; > } > @@ -1916,6 +1971,18 @@ QemuOptsList qemu_common_drive_opts = { > .type = QEMU_OPT_NUMBER, > .help = "limit write operations per second", > },{ > + .name = "iops_threshold", > + .type = QEMU_OPT_NUMBER, > + .help = "total I/O operations threshold", > + },{ > + .name = "iops_rd_threshold", > + .type = QEMU_OPT_NUMBER, > + .help = "read operations threshold", > + },{ > + .name = "iops_wr_threshold", > + .type = QEMU_OPT_NUMBER, > + .help = "write operations threshold", > + },{ > .name = "bps", > .type = QEMU_OPT_NUMBER, > .help = "limit total bytes per second", > @@ -1928,6 +1995,18 @@ QemuOptsList qemu_common_drive_opts = { > .type = QEMU_OPT_NUMBER, > .help = "limit write bytes per second", > },{ > + .name = "bps_threshold", > + .type = QEMU_OPT_NUMBER, > + .help = "total bytes threshold", > + },{ > + .name = "bps_rd_threshold", > + .type = QEMU_OPT_NUMBER, > + .help = "read bytes threshold", > + },{ > + .name = "bps_wr_threshold", > + .type = QEMU_OPT_NUMBER, > + .help = "write bytes threshold", > + },{ > .name = "copy-on-read", > .type = QEMU_OPT_BOOL, > .help = "copy read data from backing file into image file", > diff --git a/hmp.c b/hmp.c > index dc4d8d4..d75aa99 100644 > --- a/hmp.c > +++ b/hmp.c > @@ -340,14 +340,28 @@ void hmp_info_block(Monitor *mon, const QDict *qdict) > { > monitor_printf(mon, " I/O throttling: bps=%" PRId64 > " bps_rd=%" PRId64 " bps_wr=%" PRId64 > + " bps_threshold=%" PRId64 > + " bps_rd_threshold=%" PRId64 > + " bps_wr_threshold=%" PRId64 > " iops=%" PRId64 " iops_rd=%" PRId64 > - " iops_wr=%" PRId64 "\n", > + " iops_wr=%" PRId64 > + " iops_threshold=%" PRId64 > + " iops_rd_threshold=%" PRId64 > + " iops_wr_threshold=%" PRId64 "\n", > info->value->inserted->bps, > info->value->inserted->bps_rd, > info->value->inserted->bps_wr, > + info->value->inserted->bps_threshold, > + info->value->inserted->bps_rd_threshold, > + info->value->inserted->bps_wr_threshold, > info->value->inserted->iops, > info->value->inserted->iops_rd, > - info->value->inserted->iops_wr); > + info->value->inserted->iops_wr, > + info->value->inserted->iops_threshold, > + info->value->inserted->iops_rd_threshold, > + info->value->inserted->iops_wr_threshold); > + } else { > + monitor_printf(mon, " [not inserted]"); > } > > if (verbose) { > @@ -1094,7 +1108,19 @@ void hmp_block_set_io_throttle(Monitor *mon, const > QDict *qdict) > qdict_get_int(qdict, "bps_wr"), > qdict_get_int(qdict, "iops"), > qdict_get_int(qdict, "iops_rd"), > - qdict_get_int(qdict, "iops_wr"), &err); > + qdict_get_int(qdict, "iops_wr"), > + false, /* no burst threshold via QMP */ > + 0, > + false, > + 0, > + false, > + 0, > + false, > + 0, > + false, > + 0, > + false, > + 0, &err); > hmp_handle_error(mon, &err); > } > > diff --git a/qapi-schema.json b/qapi-schema.json > index 7b9fef1..a6f3792 100644 > --- a/qapi-schema.json > +++ b/qapi-schema.json > @@ -769,6 +769,18 @@ > # > # @image: the info of image used (since: 1.6) > # > +# @bps_threshold: #optional total threshold in bytes (Since 1.6)
Could you document how is @bps_threshold used and what is the difference with @bps, please? Maybe it's obvious in "leaky bucket" context, but users doesn't care the implementation algorithm, they may ask why they need @bps and @bps_threshold? And my understanding on this is: after setting @iops_threshold to 10000, the very first 10000 ops are guaranteed not throttled, in just one shot. After that, throttling algorithm is enabled, and @iops_threshold is reset to ineffective. Is it so? > +# > +# @bps_rd_threshold: #optional read threshold in bytes (Since 1.6) > +# > +# @bps_wr_threshold: #optional write threshold in bytes (Since 1.6) > +# > +# @iops_threshold: #optional total I/O operations threshold (Since 1.6) > +# > +# @iops_rd_threshold: #optional read I/O operations threshold (Since 1.6) > +# > +# @iops_wr_threshold: #optional write I/O operations threshold (Since 1.6) > +# > # Since: 0.14.0 > # > # Notes: This interface is only found in @BlockInfo. > @@ -779,7 +791,10 @@ > 'encrypted': 'bool', 'encryption_key_missing': 'bool', > 'bps': 'int', 'bps_rd': 'int', 'bps_wr': 'int', > 'iops': 'int', 'iops_rd': 'int', 'iops_wr': 'int', > - 'image': 'ImageInfo' } } > + 'image': 'ImageInfo', > + '*bps_threshold': 'int', '*bps_rd_threshold': 'int', > + '*bps_wr_threshold': 'int', '*iops_threshold': 'int', > + '*iops_rd_threshold': 'int', '*iops_wr_threshold': 'int' }} > > ## > # @BlockDeviceIoStatus: > @@ -2158,6 +2173,18 @@ > # > # @iops_wr: write I/O operations per second > # > +# @bps_threshold: #optional total threshold in bytes (Since 1.6) > +# > +# @bps_rd_threshold: #optional read threshold in bytes (Since 1.6) > +# > +# @bps_wr_threshold: #optional write threshold in bytes (Since 1.6) > +# > +# @iops_threshold: #optional total I/O operations threshold (Since 1.6) > +# > +# @iops_rd_threshold: #optional read I/O operations threshold (Since 1.6) > +# > +# @iops_wr_threshold: #optional write I/O operations threshold (Since 1.6) > +# > # Returns: Nothing on success > # If @device is not a valid block device, DeviceNotFound > # > @@ -2165,7 +2192,10 @@ > ## > { 'command': 'block_set_io_throttle', > 'data': { 'device': 'str', 'bps': 'int', 'bps_rd': 'int', 'bps_wr': 'int', > - 'iops': 'int', 'iops_rd': 'int', 'iops_wr': 'int' } } > + 'iops': 'int', 'iops_rd': 'int', 'iops_wr': 'int', > + '*bps_threshold': 'int', '*bps_rd_threshold': 'int', > + '*bps_wr_threshold': 'int', '*iops_threshold': 'int', > + '*iops_rd_threshold': 'int', '*iops_wr_threshold': 'int' }} > > ## > # @block-stream: > diff --git a/qemu-options.hx b/qemu-options.hx > index 4e98b4f..4d5ee66 100644 > --- a/qemu-options.hx > +++ b/qemu-options.hx > @@ -409,7 +409,7 @@ DEF("drive", HAS_ARG, QEMU_OPTION_drive, > " > [,cache=writethrough|writeback|none|directsync|unsafe][,format=f]\n" > " [,serial=s][,addr=A][,id=name][,aio=threads|native]\n" > " [,readonly=on|off][,copy-on-read=on|off]\n" > - " > [[,bps=b]|[[,bps_rd=r][,bps_wr=w]]][[,iops=i]|[[,iops_rd=r][,iops_wr=w]]\n" > + " > [[,bps=b]|[[,bps_rd=r][,bps_wr=w]]][[,iops=i]|[[,iops_rd=r][,iops_wr=w][,bps_threshold=bt]|[[,bps_rd_threshold=rt][,bps_wr_threshold=wt]]][[,iops_threshold=it]|[[,iops_rd_threshold=rt][,iops_wr_threshold=wt]]\n" This line is so long, can you wrap it? > " use 'file' as a drive image\n", QEMU_ARCH_ALL) > STEXI > @item -drive @var{option}[,@var{option}[,@var{option}[,...]]] > diff --git a/qmp-commands.hx b/qmp-commands.hx > index e075df4..11c638a 100644 > --- a/qmp-commands.hx > +++ b/qmp-commands.hx > @@ -1385,7 +1385,7 @@ EQMP > > { > .name = "block_set_io_throttle", > - .args_type = > "device:B,bps:l,bps_rd:l,bps_wr:l,iops:l,iops_rd:l,iops_wr:l", > + .args_type = > "device:B,bps:l,bps_rd:l,bps_wr:l,iops:l,iops_rd:l,iops_wr:l,bps_threshold:l?,bps_rd_threshold:l?,bps_wr_threshold:l?,iops_threshold:l?,iops_rd_threshold:l?,iops_wr_threshold:l?", Same here. > .mhandler.cmd_new = qmp_marshal_input_block_set_io_throttle, > }, > > @@ -1400,10 +1400,16 @@ Arguments: > - "device": device name (json-string) > - "bps": total throughput limit in bytes per second(json-int) > - "bps_rd": read throughput limit in bytes per second(json-int) > -- "bps_wr": read throughput limit in bytes per second(json-int) > +- "bps_wr": write throughput limit in bytes per second(json-int) > - "iops": total I/O operations per second(json-int) > - "iops_rd": read I/O operations per second(json-int) > - "iops_wr": write I/O operations per second(json-int) > +- "bps_threshold": total threshold in bytes(json-int) > +- "bps_rd_threshold": read threshold in bytes(json-int) > +- "bps_wr_threshold": write threshold in bytes(json-int) > +- "iops_threshold": total I/O operations threshold(json-int) > +- "iops_rd_threshold": read I/O operations threshold(json-int) > +- "iops_wr_threshold": write I/O operations threshold(json-int) > > Example: > > @@ -1413,7 +1419,13 @@ Example: > "bps_wr": "0", > "iops": "0", > "iops_rd": "0", > - "iops_wr": "0" } } > + "iops_wr": "0", > + "bps_threshold": "8000000", > + "bps_rd_threshold": "0", > + "bps_wr_threshold": "0", > + "iops_threshold": "0", > + "iops_rd_threshold": "0", > + "iops_wr_threshold": "0" } } > <- { "return": {} } > > EQMP > @@ -1754,6 +1766,12 @@ Each json-object contain the following: > - "iops": limit total I/O operations per second (json-int) > - "iops_rd": limit read operations per second (json-int) > - "iops_wr": limit write operations per second (json-int) > + - "bps_threshold": total threshold in bytes(json-int) > + - "bps_rd_threshold": read threshold in bytes(json-int) > + - "bps_wr_threshold": write threshold in bytes(json-int) > + - "iops_threshold": total I/O operations threshold(json-int) > + - "iops_rd_threshold": read I/O operations threshold(json-int) > + - "iops_wr_threshold": write I/O operations threshold(json-int) > - "image": the detail of the image, it is a json-object containing > the following: > - "filename": image file name (json-string) > @@ -1823,6 +1841,12 @@ Example: > "iops":1000000, > "iops_rd":0, > "iops_wr":0, > + "bps_threshold": "8000000", > + "bps_rd_threshold": "0", > + "bps_wr_threshold": "0", > + "iops_threshold": "0", > + "iops_rd_threshold": "0", > + "iops_wr_threshold": "0", > "image":{ > "filename":"disks/test.qcow2", > "format":"qcow2", > -- > 1.7.10.4 > > -- Fam