dwww Home | Manual pages | Find package

Smokeping_probes_basevars(3)       SmokePing       Smokeping_probes_basevars(3)

NAME
       Smokeping::probes::basevars - Another Base Class for implementing
       SmokePing Probes

OVERVIEW
       Like Smokeping::probes::base, but supports host-specific variables for
       the probe.

SYNOPSIS
        *** Probes ***

        +basevars

        offset = 50%
        pings = 20
        step = 300

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

        # [...]

        *** Targets ***

        probe = basevars # if this should be the default probe

        # [...]

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

DESCRIPTION
       Provides the method `targets' that returns a list of hashes.  The hashes
       contain the entries:

       addr
           The address of the target.

       vars
           A  hash  containing  variables  defined  in the corresponding config
           section.

       tree
           The unique index that `probe::base' uses for targets.

           There's also the method 'vars' that returns the above mentioned hash
           corresponding to the 'tree' index parameter.

VARIABLES
       Supported probe-specific variables:

       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%

       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

       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

AUTHORS
       Niko Tyni <ntyni@iki.fi>

BUGS
       Uses `Smokeping::probes::base' internals too much to be a derived class,
       but I didn't want to touch the base class directly.

SEE ALSO
       Smokeping::probes::base, Smokeping::probes::EchoPing

2.8.2                              2024-02-04      Smokeping_probes_basevars(3)

Generated by dwww version 1.16 on Tue Dec 16 07:04:51 CET 2025.