1Smokeping_probes_FPing(3) SmokePing Smokeping_probes_FPing(3)
2
6 Smokeping::probes::FPing - FPing Probe for SmokePing
7
9 *** Probes ***
10 +FPing
12 binary = /usr/bin/fping # mandatory
14 blazemode = true
15 hostinterval = 1.5
16 mininterval = 0.001
17 offset = 50%
18 packetsize = 5000
19 pings = 20
20 sourceaddress = 192.168.0.1
21 step = 300
22 timeout = 1.5
23 tos = 0x20
24 usestdout = true
25 # [...]
27 *** Targets ***
29 probe = FPing # if this should be the default probe
31 # [...]
33 + mytarget
35 # probe = FPing # if the default probe is something else
36 host = my.host
37
39 Integrates FPing as a probe into smokeping. The variable binary must
40 point to your copy of the FPing program. If it is not installed on
41 your system yet, you can get a slightly enhanced version from "pub" in
42 www.smokeping.org.
43 The (optional) packetsize option lets you configure the packetsize for
45 the pings sent.
46 Since version 3.3 fping sends its statistics to stdout. Set usestdout
48 to 'true' so make smokeping read stdout instead of stderr.
49 In blazemode, FPing sends one more ping than requested, and discards
51 the first RTT value returned as it's likely to be an outlier.
52 The FPing manpage has the following to say on this topic:
54 Number of bytes of ping data to send. The minimum size (normally 12)
56 allows room for the data that fping needs to do its work (sequence
57 number, timestamp). The reported received data size includes the IP
58 header (normally 20 bytes) and ICMP header (8 bytes), so the minimum
59 total size is 40 bytes. Default is 56, as in ping. Maximum is the
60 theoretical maximum IP datagram size (64K), though most systems limit
61 this to a smaller, system-dependent number.
62
64 Supported probe-specific variables:
65 binary
67 The location of your fping binary.
68 Example value: /usr/bin/fping
70 This setting is mandatory.
72 blazemode
74 Send an extra ping and then discarge the first answer since the
75 first is bound to be an outliner.
76 Example value: true
78 hostinterval
80 The fping "-p" parameter, but in (possibly fractional) seconds
81 rather than milliseconds, for consistency with other Smokeping
82 probes. From fping(1):
83 This parameter sets the time that fping waits between successive
85 packets to an individual target.
86 Example value: 1.5
88 mininterval
90 The fping "-i" parameter, but in (probably fractional) seconds
91 rather than milliseconds, for consistency with other Smokeping
92 probes. From fping(1):
93 The minimum amount of time between sending a ping packet to any
95 target.
96 Example value: 0.001
98 Default value: 0.01
100 offset
102 If you run many probes concurrently you may want to prevent them
103 from hitting your network all at the same time. Using the probe-
104 specific offset parameter you can change the point in time when
105 each probe will be run. Offset is specified in % of total interval,
106 or alternatively as 'random', and the offset from the 'General'
107 section is used if nothing is specified here. Note that this does
108 NOT influence the rrds itself, it is just a matter of when data
109 acqusition is initiated. (This variable is only applicable if the
110 variable 'concurrentprobes' is set in the 'General' section.)
111 Example value: 50%
113 packetsize
115 The ping packet size (in the range of 12-64000 bytes).
116 Example value: 5000
118 pings
120 How many pings should be sent to each target, if different from the
121 global value specified in the Database section. Note that the
122 number of pings in the RRD files is fixed when they are originally
123 generated, and if you change this parameter afterwards, you'll have
124 to delete the old RRD files or somehow convert them.
125 Example value: 20
127 sourceaddress
129 The fping "-S" parameter . From fping(1):
130 Set source address.
132 Example value: 192.168.0.1
134 step
136 Duration of the base interval that this probe should use, if
137 different from the one specified in the 'Database' section. Note
138 that the step in the RRD files is fixed when they are originally
139 generated, and if you change the step parameter afterwards, you'll
140 have to delete the old RRD files or somehow convert them. (This
141 variable is only applicable if the variable 'concurrentprobes' is
142 set in the 'General' section.)
143 Example value: 300
145 timeout
147 The fping "-t" parameter, but in (possibly fractional) seconds
148 rather than milliseconds, for consistency with other Smokeping
149 probes. Note that as Smokeping uses the fping 'counting' mode (-C),
150 this apparently only affects the last ping.
151 Example value: 1.5
153 tos Set the type of service (TOS) of outgoing ICMP packets. You need
155 at laeast fping-2.4b2_to3-ipv6 for this to work. Find a copy on
156 www.smokeping.org/pub.
157 Example value: 0x20
159 usestdout
161 Listen for FPing output on stdout instead of stderr ... (version
162 3.3+ sends its statistics on stdout).
163 Example value: true
165
167 Tobias Oetiker <tobi@oetiker.ch>
1682.7.2 2020-01-30 Smokeping_probes_FPing(3)