From e96871a1271430da416360b65e68dc727fba4938 Mon Sep 17 00:00:00 2001 From: Michael Klishin Date: Wed, 7 Feb 2024 09:58:48 -0500 Subject: [PATCH] Backport #1796 --- site/streams.md | 28 +++++++++++++++++++++------- 1 file changed, 21 insertions(+), 7 deletions(-) diff --git a/site/streams.md b/site/streams.md index f7d4b3664b..70ab6e58f4 100644 --- a/site/streams.md +++ b/site/streams.md @@ -113,11 +113,11 @@ so uneven cluster sizes is strongly recommended. A stream remains an AMQP 0.9.1 queue, so it can be bound to any exchange after its creation, just as any other RabbitMQ queue. -If declaring using [management UI](./management.html), the `stream` type must be specified using +If declaring using [management UI](./management), the `stream` type must be specified using the queue type drop down menu. -Streams support 3 additional [queue arguments](./queues.html#optional-arguments) -that are best configured using a [policy](./parameters.html#policies) +Streams support additional [queue arguments](./queues#optional-arguments) +that also can be configured using a [policy](./parameters#policies) * `x-max-length-bytes` @@ -129,12 +129,26 @@ Sets the maximum age of the stream. See [retention](#retention). Default: not se * `x-stream-max-segment-size-bytes` -Unit: bytes. A stream is divided up into fixed size segment files on disk. +Unit: bytes. + +A stream is divided up into fixed size segment files on disk. This setting controls the size of these. -Default: 500000000 bytes (500 MB). +Default: (500000000 bytes). + +While this argument can be configured via a policy, it will _only_ be applied +to the stream if the policy is set at stream declaration time. If this argument +is changed for a matching but pre-existing stream it **will not be changed** even +if the effective policy of the queue record may indicate it is. + +Hence it is best to only configure this via an option queue argument: + +* `x-stream-filter-size-bytes` + +The value is set in bytes. -The following snippet shows how to set the maximum size of a stream to 20 GB, with -segment files of 100 MB: +The size of the Bloom filter used for [filtering](#filtering). +The value must be between 16 and 255. +Default: 16. 
 Map<String, Object> arguments = new HashMap<>();