Smokeping_probes_EchoPingWhois(3)

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

💫 Smokeping_probes_EchoPingWhois(3) 💫

okay bestie, so this is a SmokePing probe page — specifically Smokeping::probes::EchoPingWhois, and yes the whole thing is about measuring whois roundtrip times. ICONIC. Let's get into it 🫶

✨ NAME ✨

Smokeping::probes::EchoPingWhois — an echoping(1) probe for SmokePing. That's it, that's the vibe. 💅

🦋 OVERVIEW 🦋

So what does it actually do? It measures whois roundtrip times for SmokePing, using the echoping_whois plugin. Literally that's the whole concept and it ate. 🔥

🌸 SYNOPSIS 🌸

Here's the whole config sitch, copy-paste energy:

 *** Probes ***

 +EchoPingWhois

 binary = /usr/bin/echoping
 forks = 5
 offset = 50%
 step = 300

 # The following variables can be overridden in each target section
 /^influx_.+/ = influx_location = In the basement
 extraopts = -some-letter-the-author-did-not-think-of
 ipversion = 4
 pings = 5
 plugin = /path/to/whois.so
 pluginargs = -p plugin_specific_arg
 priority = 6
 timeout = 1
 tos = 0xa0
 waittime = 1
 whois_request = example.org # mandatory

 # [...]

 *** Targets ***

 probe = EchoPingWhois # if this should be the default probe

 # [...]

 + mytarget
 # probe = EchoPingWhois # if the default probe is something else
 host = my.host
 /^influx_.+/ = influx_location = In the basement
 extraopts = -some-letter-the-author-did-not-think-of
 ipversion = 4
 pings = 5
 plugin = /path/to/whois.so
 pluginargs = -p plugin_specific_arg
 priority = 6
 timeout = 1
 tos = 0xa0
 waittime = 1
 whois_request = example.org # mandatory

🎀 VARIABLES 🎀

💖 Supported probe-specific variables 💖

  • binary — where your echoping binary is chillin'. Default value: /usr/bin/echoping. 🐧
  • forks — run this many concurrent processes at maximum. Example value: 5. Default value: 5. multiprocessing queen 👑
  • offset — okay so if you're running many probes at once, you probs don't want them all slamming your network at the exact same second, right? With this probe-specific offset param you can change when each probe runs. Offset is specified in % of total interval, or alternatively as 'random', and if you don't specify anything here the offset from the 'General' section gets used. Heads up: this does NOT influence the rrds themselves — it's just a matter of when data acquisition is initiated. (This variable is only applicable if the variable 'concurrentprobes' is set in the 'General' section.) Example value: 50% ⏰
  • step — duration of the base interval this probe should use, if it's different from the one in the 'Database' section. Quick warning bestie: the step in the RRD files is fixed when they're originally generated, so if you change the step parameter afterwards you'll have to delete the old RRD files or somehow convert them. (This variable is only applicable if the variable 'concurrentprobes' is set in the 'General' section.) Example value: 300 📏

🌈 Supported target-specific variables 🌈

  • /^influx_.+/ — this is a tag that gets sent to influxdb and has zero impact on the probe measurement. The tag name gets sent without the "influx_" prefix, which is replaced with "tag_" instead. Tags can be used for filtering. Example value: influx_location = In the basement 🏠
  • extraopts — any extra options you put here get passed unmodified to echoping(1). Example value: -some-letter-the-author-did-not-think-of 🙈
  • ipversion — the IP protocol used. Possible values are "4" and "6". Passed to echoping(1) as the "-4" or "-6" options. Example value: 4 🌐
  • pings — how many pings should be sent to each target, if different from the global value in the Database section. Note that the number of pings in the RRD files is fixed when they're originally generated, and if you change this parameter afterwards you'll have to delete the old RRD files or somehow convert them. Example value: 5 📡
  • plugin — the echoping plugin that will be used. See echoping(1) for details. This can either be the name of the plugin or a full path to the plugin shared object. Example value: /path/to/whois.so. Default value: whois. 🔌
  • pluginargs — any extra arguments needed by the echoping plugin specified with the pluginname variable. These are generally provided by the subclass probe. Example value: -p plugin_specific_arg 🧩
  • priority — the "-p" echoping(1) option. Example value: 6 ⭐
  • timeout — the "-t" echoping(1) option. Example value: 1. Default value: 5 ⌛
  • tos — the "-P" echoping(1) option. Example value: 0xa0 🎯
  • waittime — the "-w" echoping(1) option. Example value: 1 ⏳
  • whois_request — the request to the whois server (typically a domain name). Example value: example.org. This setting is mandatory. no cap, you gotta have it 💀

👑 AUTHORS 👑

Niko Tyni <ntyni@iki.fi> — credited, respected, periodt. 🫡

💀 NOTES 💀

  • The fill, size and udp EchoPing variables are not valid. nope, not a thing here 🙅‍♀️
  • Plugins, including echoping_whois, are available starting with echoping version 6. so check your version bestie 🧚

🔥 SEE ALSO 🔥

  • Smokeping::probes::EchoPing
  • Smokeping::probes::EchoPingPlugin

go read those too, iykyk 💜

that's the whole page, bestie — version 2.9.0, dated 2025-06-30, brought to you by the SmokePing girlies 🎀✨ slay responsibly 🌸

📦 where this page comes from