From bcfd5e8a2ba8b29f142f319189710a78bea0cb14 Mon Sep 17 00:00:00 2001 From: Doug Koerich Date: Thu, 8 Oct 2026 17:42:31 -0300 Subject: [PATCH 1/2] Momentum#1747 adaptive custom rules: a trigger N/S fires at N occurrences The page said more than N; a rule fires on the Nth occurrence within the period, locally and cluster-wide. Co-Authored-By: Claude Opus 5.5 (1M context) Signed-off-by: Doug Koerich --- content/momentum/3/3-ad/ad-custom-rules.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/momentum/3/3-ad/ad-custom-rules.md b/content/momentum/3/3-ad/ad-custom-rules.md index 2f02c3db8..c93846212 100644 --- a/content/momentum/3/3-ad/ad-custom-rules.md +++ b/content/momentum/3/3-ad/ad-custom-rules.md @@ -55,7 +55,7 @@ The elements of the responses table are as follows: * `trigger` – The trigger threshold - If this element is set to `1`, the action is triggered on the first occurrence of the code. You can also set this to the number of occurrences per given period. For example, `10/1` triggers the action when more than 10 occurrences of this code are detected per second. + If this element is set to `1`, the action is triggered on the first occurrence of the code. You can also set this to the number of occurrences per given period. For example, `10/1` triggers the action when 10 or more occurrences of this code are detected within one second. * `action` – The action to take when a rule is triggered. Valid actions are as follows: From 89bf5912bee47c1372f16c90bf8ed542280e11e7 Mon Sep 17 00:00:00 2001 From: Doug Koerich Date: Fri, 9 Oct 2026 10:27:27 -0300 Subject: [PATCH 2/2] Momentum#1747 adaptive rules: C/S triggers on the Cth occurrence; 1/S acts like 1 The rules appendix said "when the rate is crossed"; it now matches the reworded adaptive_rules.lua comment, and the custom rules page says a count of 1 per period fires on every occurrence. Signed-off-by: Doug Koerich Co-Authored-By: Claude Opus 5.5 (1M context) --- content/momentum/3/3-ad/ad-appendix-adaptive-rules.md | 3 ++- content/momentum/3/3-ad/ad-custom-rules.md | 2 +- 2 files changed, 3 insertions(+), 2 deletions(-) diff --git a/content/momentum/3/3-ad/ad-appendix-adaptive-rules.md b/content/momentum/3/3-ad/ad-appendix-adaptive-rules.md index 0251dc9ca..fae11957d 100644 --- a/content/momentum/3/3-ad/ad-appendix-adaptive-rules.md +++ b/content/momentum/3/3-ad/ad-appendix-adaptive-rules.md @@ -50,7 +50,8 @@ received during a delivery attempt. trigger: triggering threshold if set to 1, trigger on the first occurrence if set to "C/S", where C is a count and S is a number of seconds, - (e.g. 10/1 for 10 per second) trigger when the rate is crossed + trigger on the Cth occurrence within S seconds (e.g. 10/1: the + 10th occurrence within one second) action: the action to take when the rule is triggered. {"suspend", "4 hours"} -- causes suspension for 4 hours {"blackhole", "4 hours"} -- blackhole domain for 4 hours diff --git a/content/momentum/3/3-ad/ad-custom-rules.md b/content/momentum/3/3-ad/ad-custom-rules.md index c93846212..f85543163 100644 --- a/content/momentum/3/3-ad/ad-custom-rules.md +++ b/content/momentum/3/3-ad/ad-custom-rules.md @@ -55,7 +55,7 @@ The elements of the responses table are as follows: * `trigger` – The trigger threshold - If this element is set to `1`, the action is triggered on the first occurrence of the code. You can also set this to the number of occurrences per given period. For example, `10/1` triggers the action when 10 or more occurrences of this code are detected within one second. + If this element is set to `1`, the action is triggered on the first occurrence of the code. You can also set this to the number of occurrences per given period. For example, `10/1` triggers the action when 10 or more occurrences of this code are detected within one second. A count of 1 per period (for example, `1/60`) triggers on every occurrence, like `1`. * `action` – The action to take when a rule is triggered. Valid actions are as follows: