..::lib::Smok...onsecutiveLoss(3)

📦
version 2.9.0 · 10 versions
, in alpine 3.23, alpine 3.24

💖 NAME 💖

ok so Smokeping::matchers::ConsecutiveLoss — it's the matcher that raises and clears alerts however you want, based on your pick of threshold and consecutive values. basically you're the main character here, you decide the rules 👑

✨ DESCRIPTION ✨

bestie, this matcher is literally the vibe check for your alerts 🎀 You use it to raise and clear alerts according to your choice of threshold and consecutive values.

Like, say you wanna raise an alert on the first occurrence of 50% packet loss, but you're not dramatic and you'd rather hold that alert active until packet loss stays below 10% for 5 consecutive measurements. That's the whole energy. slay. 💅

To add the matcher to your config file, use this syntax:

type = matcher
edgetrigger = yes
pattern =  ConsecutiveLoss(pctlossraise=>##,stepsraise=>##,pctlossclear=>##,stepsclear=>##)

Replace the ## with integers of your choice — here's the reference, no cap 🫶:

  • pctlossraise — loss values at or above this percentage will raise an alert when…
  • stepsraise — … this number of consecutive values have been collected
  • pctlossclear — loss values below this percentage will clear an alert when…
  • stepsclear — … this number of consecutive values have been collected

Ngl, in my environment, I define four alerts for levels like this 👇

+packetloss_significant_instantalert
type = matcher
pattern = ConsecutiveLoss(pctlossraise=>10,stepsraise=>1,pctlossclear=>3,stepsclear=>3)
comment = Instant alert - Significant packet loss detected (At least 10% over 1 cycle). Alert will clear when loss stays at max 2% for 3 cycles
priority = 30

+packetloss_major_instantalert
type = matcher
pattern = ConsecutiveLoss(pctlossraise=>25,stepsraise=>1,pctlossclear=>3,stepsclear=>3)
comment = Instant alert - Major packet loss detected (At least 25% over 1 cycle). Alert will clear when loss stays at max 2% for 3 cycles
priority = 20

+packetloss_significant_consecutivealert
type = matcher
pattern = ConsecutiveLoss(pctlossraise=>10,stepsraise=>3,pctlossclear=>3,stepsclear=>5)
comment = Consecutive occurrence of significant packet loss detected (At least 10% over 3 cycles). Alert will clear when loss stays at max 2% for 5 cycles.
priority = 10

+packetloss_major_consecutivealert
type = matcher
pattern = ConsecutiveLoss(pctlossraise=>25,stepsraise=>3,pctlossclear=>3,stepsclear=>5)
comment = Consecutive occurrence of significant packet loss detected (At least 25% over 3 cycles). Alert will clear when loss stays at max 2% for 5 cycles.
priority = 5

Copyright (c) 2017 Rickard Borgmaster

🦋 LICENSE 🦋

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

🧚 AUTHOR 🧚

Rickard Borgmaster. 2017. Based on the CheckLoss/Checklatency matchers by Dylan Vanderhoof 2006.

💜 that's the whole page, bestie — go forth and configure your alerts, iykyk 💜

ok bye ily, this was SmokePing version 2.9.0, dated 2025-06-30 🍓✨

📦 where this page comes from