dwww Home | Manual pages | Find package

Smokeping_prob...PingContinuous(3) SmokePing Smokeping_prob...PingContinuous(3)

NAME
       Smokeping::probes::FPingContinuous - FPingContinuous Probe for SmokePing

SYNOPSIS
        *** Probes ***

        +FPingContinuous

        binary = /usr/bin/fping # mandatory
        hostinterval = 1.5
        offset = 50%
        packetsize = 5000
        pings = 20
        sourceaddress = 192.168.0.1
        step = 300
        timeout = 1.5
        tos = 0x20
        usestdout = false

        # The following variables can be overridden in each target section
        /^influx_.+/ = influx_location = In the basement

        # [...]

        *** Targets ***

        probe = FPingContinuous # if this should be the default probe

        # [...]

        + mytarget
        # probe = FPingContinuous # if the default probe is something else
        host = my.host
        /^influx_.+/ = influx_location = In the basement

DESCRIPTION
       Integrates FPingContinuous as a probe into smokeping. The variable
       binary must point to your copy of the FPing program.  If it is not
       installed on your system yet, you can get a slightly enhanced version
       from "pub" in www.smokeping.org.

       The (optional) packetsize option lets you configure the packetsize for
       the pings sent.

       Continuous output is normally sent to stdout, but you can set usestdout
       to 'false' to make smokeping read stderr instead of stdout.

       The FPing manpage has the following to say on this topic:

       Number of bytes of ping data to send.  The minimum size (normally 12)
       allows room for the data that fping needs to do its work (sequence
       number, timestamp).  The reported received data size includes the IP
       header (normally 20 bytes) and ICMP header (8 bytes), so the minimum
       total size is 40 bytes.  Default is 56, as in ping. Maximum is the
       theoretical maximum IP datagram size (64K), though most systems limit
       this to a smaller, system-dependent number.

VARIABLES
       Supported probe-specific variables:

       binary
           The location of your fping binary.

           Example value: /usr/bin/fping

           This setting is mandatory.

       hostinterval
           The  fping  "-p"  parameter,  but  in  (possibly fractional) seconds
           rather than  milliseconds,  for  consistency  with  other  Smokeping
           probes. From fping(1):

           This  parameter  sets  the time that fping  waits between successive
           packets to an individual target.

           Example value: 1.5

       offset
           If you run many probes concurrently you may  want  to  prevent  them
           from  hitting  your  network  all at the same time. Using the probe-
           specific offset parameter you can change the point in time when each
           probe will be run. Offset is specified in % of  total  interval,  or
           alternatively as 'random', and the offset from the 'General' section
           is  used  if  nothing  is  specified  here.  Note that this does NOT
           influence the rrds  itself,  it  is  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%

       packetsize
           The ping packet size (in the range of 12-64000 bytes).

           Example value: 5000

       pings
           How many pings should be sent to each target, if different from  the
           global value specified in the Database section. Note that the number
           of  pings  in  the  RRD  files  is  fixed  when  they are originally
           generated, and if you change this parameter afterwards, you'll  have
           to delete the old RRD files or somehow convert them.

           Example value: 20

       sourceaddress
           The fping "-S" parameter . From fping(1):

           Set source address.

           Example value: 192.168.0.1

       step
           Duration  of  the  base  interval  that  this  probe  should use, if
           different from the one specified in  the  'Database'  section.  Note
           that  the  step  in  the RRD files is fixed when they are originally
           generated, and 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

       timeout
           The  fping  "-t"  parameter,  but  in  (possibly fractional) seconds
           rather than  milliseconds,  for  consistency  with  other  Smokeping
           probes.  Note that as Smokeping uses the fping 'counting' mode (-C),
           this apparently only affects the last ping.

           Example value: 1.5

       tos Set the type of service (TOS) of outgoing ICMP packets.  You need at
           laeast fping-2.4b2_to3-ipv6  for  this  to  work.  Find  a  copy  on
           www.smokeping.org/pub.

           Example value: 0x20

       usestdout
           Listen  for FPing output on stdout instead of stderr ... (continuous
           output is normally sent to stdout).

           Example value: false

AUTHORS
       Steven Wilton <swilton@fluentit.com.au> Tobias Oetiker <tobi@oetiker.ch>

2.8.2                              2024-02-04Smokeping_prob...PingContinuous(3)

Generated by dwww version 1.16 on Tue Dec 16 07:10:34 CET 2025.