Skip to main content
Version: v4.21

throttle

Limits the bandwidth of a pipeline.

Synopsis

throttle <bandwidth> [--within <duration>]

Description

The throttle operator limits the amount of data flowing through it to a bandwidth.

<bandwidth>

An unsigned integer giving the maximum bandwidth that is enforced for this pipeline, in bytes per the specified interval.

--within <duration>

The duration in which to measure the maximum bandwidth.

Defaults to 1s.

Examples

Read a TCP stream and print the data to stdout at a rate of 1 character per second:

load tcp://0.0.0.0:4000 | throttle 1

Load a sample input data file at a speed of at most 1MiB every 10s and import it into the node:

load https://storage.googleapis.com/tenzir-datasets/M57/zeek-all.log.zst
| throttle 1Mi --window 10s
| decompress zstd
| read zeek-tsv
| import