..::lib::Smoke...hers::Avgratio(3)

🎀 NAME 🎀

okay bestie, welcome to the SmokePing manual page for Smokeping::matchers::Avgratio 💅 its whole job? detect changes in average median latency. periodt.

🌸 OVERVIEW 🌸

so the Avgratio matcher builds up a historic average median latency over several measurement rounds. then it compares that average against a second average latency value that's also built over several rounds of measurement. it's giving "past latency vs current latency" vibe check, yk? ✨

✨ DESCRIPTION ✨

call the matcher with this exact sequence, no cap:

type = matcher
pattern =  Avgratio(historic=>a,current=>b,comparator=>o,percentage=>p)

🎛️ the params, bestie 🎛️

• historic — the number of median values to use for building the 'historic' average.
• current — the number of median values to use for building the 'current' average.
• comparator — which comparison operator should be used to compare current/historic with percentage.
• percentage — right hand side of the comparison.

then the timeline situation is literally:

         old <--- historic ---><--- current ---> now

🔥 EXAMPLE 🔥

okay so build the average median latency over 10 samples, use that to divide the current average latency built over 2 samples, and check if it's bigger than 150%. the code is:

 Avgratio(historic=>10,current=>2,comparator=>'>',percentage=>150);

 avg(current)/avg(historic) > 150/100

this means the matcher will activate when the current latency average is more than 1.5 times the historic latency average established over the last 10 rounds of measurement. yes bestie, 1.5x is the threshold, and it ate. 💅

👑 COPYRIGHT 👑

Copyright (c) 2004 by OETIKER+PARTNER AG. All rights reserved.

🫶 SPONSORSHIP 🫶

the development of this matcher has been sponsored by Virtela Communications, <http://www.virtela.net/>. iconic support, fr fr 🫶

💜 LICENSE 💜

okay legal bestie moment, here's the actual license tea:

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 🦋

Tobias Oetiker <tobi@oetiker.ch> — author icon, periodt 🌈

mwah 💋 catch u later, bestie — SmokePing 2.9.0, dated 2025-06-30, page ..::lib::Smoke...hers::Avgratio(3).