..::lib::Smok...chers::ExpLoss(3)

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

💅 ..::lib::Smok...chers::ExpLoss(3) — SmokePing's exponential weighting matcher, bestie edition ✨

okay so this little icon is a SmokePing matcher called ExpLoss, and it does exponential weighting for packet loss with RMON-like thresholds. it's giving very smart, very math, very "i actually read the RFC" energy. the manual name is SmokePing btw, in case you were wondering where we're living rn 🫶

🎀 NAME 🎀

Smokeping::matchers::ExpLoss — exponential weighting matcher for packet loss with RMON-like thresholds 💖

🦋 DESCRIPTION 🦋

so basically it matches against an exponential weighted average of the last samples, which means new values are more valuable than old ones (as they should be, main character energy only). there are two thresholds — rising and falling — and together they produce a hysteresis loop, just like in the RMON alert subsystem. iconic behavior fr fr.

the way it works: if the average reaches the "rising" threshold, the matcher goes into the "match" state and holds it until the average drops under the "falling" threshold. it's commitment, it's loyalty, it's a situationship with clear boundaries 🌸

call the matcher with the following sequence:

 type = matcher
 pattern = ExpLoss(hist => <hist>, rising=><rising> \
                  [,falling => <falling>] [,skip=><stat>] [,fast=><fast>])

⭐ Arguments ⭐

  • hist — number of samples to weight against; the weight gets disposed in an exponential decreasing manner from newest to oldest, so that the oldest sample would have 1% significance 👑
  • rising — rising threshold for packet loss, 0-100% 🔥
  • falling — falling threshold for packet loss, default is <rising> 💜
  • skip — skip <skip> number of samples after startup before "fire" alerts 🙈
  • fast — use <fast> samples for fast transition: if the values of last <fast> samples more then <rising> — take "match" state, if less then <falling> — take "no match" state 💅

💀 Note 💀

if the actual history is less then <hist> value then this value is taken as the actual history. no cap, that's just how it rolls.

Copyright (c) 2008 Veniamin Konoplev

Developed in cooperation with EU EGEE project ✨ (shoutout to the whole collaboration, love that for them)

🍓 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. 😭 (yes that's the legal shouting, it's required, i don't make the rules)

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 🧚

Veniamin Konoplev <vkonoplev@acm.org> 🫶

and that's the whole page bestie, go configure your matcher and slay 💖

version 2.9.0, dated 2025-06-30 — mwah, that's a wrap on ..::lib::Smok...chers::ExpLoss(3) ✨🎀
📦 where this page comes from