1Smokeping_probes_DNS(3)            SmokePing           Smokeping_probes_DNS(3)
2
3
4

NAME

6       Smokeping::probes::DNS - Name Service Probe for SmokePing
7

SYNOPSIS

9        *** Probes ***
10
11        +DNS
12
13        binary = /usr/bin/dig # mandatory
14        forks = 5
15        offset = 50%
16        step = 300
17        timeout = 15
18
19        # The following variables can be overridden in each target section
20        /^influx_.+/ = influx_location = In the basement
21        lookup = www.example.org
22        pings = 5
23        server = ns1.someisp.net
24
25        # [...]
26
27        *** Targets ***
28
29        probe = DNS # if this should be the default probe
30
31        # [...]
32
33        + mytarget
34        # probe = DNS # if the default probe is something else
35        host = my.host
36        /^influx_.+/ = influx_location = In the basement
37        lookup = www.example.org
38        pings = 5
39        server = ns1.someisp.net
40

DESCRIPTION

42       Integrates dig as a probe into smokeping. The variable binary must
43       point to your copy of the dig program. If it is not installed on your
44       system yet, you should install bind-utils >= 9.0.0.
45
46       The Probe asks the given host n-times for it's name. Where n is the
47       amount specified in the config File.
48

VARIABLES

50       Supported probe-specific variables:
51
52       binary
53           The location of your dig binary.
54
55           Example value: /usr/bin/dig
56
57           This setting is mandatory.
58
59       forks
60           Run this many concurrent processes at maximum
61
62           Example value: 5
63
64           Default value: 5
65
66       offset
67           If you run many probes concurrently you may want to prevent them
68           from hitting your network all at the same time. Using the probe-
69           specific offset parameter you can change the point in time when
70           each probe will be run. Offset is specified in % of total interval,
71           or alternatively as 'random', and the offset from the 'General'
72           section is used if nothing is specified here. Note that this does
73           NOT influence the rrds itself, it is just a matter of when data
74           acquisition is initiated.  (This variable is only applicable if the
75           variable 'concurrentprobes' is set in the 'General' section.)
76
77           Example value: 50%
78
79       step
80           Duration of the base interval that this probe should use, if
81           different from the one specified in the 'Database' section. Note
82           that the step in the RRD files is fixed when they are originally
83           generated, and if you change the step parameter afterwards, you'll
84           have to delete the old RRD files or somehow convert them. (This
85           variable is only applicable if the variable 'concurrentprobes' is
86           set in the 'General' section.)
87
88           Example value: 300
89
90       timeout
91           How long a single 'ping' takes at maximum
92
93           Example value: 15
94
95           Default value: 5
96
97       Supported target-specific variables:
98
99       /^influx_.+/
100           This is a tag that will be sent to influxdb and has no impact on
101           the probe measurement. The tag name will be sent without the
102           "influx_" prefix, which will be replaced with "tag_" instead. Tags
103           can be used for filtering.
104
105           Example value: influx_location = In the basement
106
107       lookup
108           Name of the host to look up in the dns.
109
110           Example value: www.example.org
111
112       pings
113           How many pings should be sent to each target, if different from the
114           global value specified in the Database section. Note that the
115           number of pings in the RRD files is fixed when they are originally
116           generated, and if you change this parameter afterwards, you'll have
117           to delete the old RRD files or somehow convert them.
118
119           Example value: 5
120
121       server
122           Name of the dns server to use.
123
124           Example value: ns1.someisp.net
125

AUTHORS

127        Igor Petrovski <pigor@myrealbox.com>,
128        Carl Elkins <carl@celkins.org.uk>,
129        Andre Stolze <stolze@uni-muenster.de>,
130        Niko Tyni <ntyni@iki.fi>,
131        Chris Poetzel<cpoetzel@anl.gov>
132
133
134
1352.8.2                             2023-07-22           Smokeping_probes_DNS(3)
Impressum