1Smokeping_probes_DNS(3) SmokePing Smokeping_probes_DNS(3)
2
6 Smokeping::probes::DNS - Name Service Probe for SmokePing
7
9 *** Probes ***
10 +DNS
12 binary = /usr/bin/dig # mandatory
14 forks = 5
15 offset = 50%
16 step = 300
17 timeout = 15
18 # 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 # [...]
26 *** Targets ***
28 probe = DNS # if this should be the default probe
30 # [...]
32 + 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
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 The Probe asks the given host n-times for it's name. Where n is the
47 amount specified in the config File.
48
50 Supported probe-specific variables:
51 binary
53 The location of your dig binary.
54 Example value: /usr/bin/dig
56 This setting is mandatory.
58 forks
60 Run this many concurrent processes at maximum
61 Example value: 5
63 Default value: 5
65 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 Example value: 50%
78 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 Example value: 300
89 timeout
91 How long a single 'ping' takes at maximum
92 Example value: 15
94 Default value: 5
96 Supported target-specific variables:
98 /^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 Example value: influx_location = In the basement
106 lookup
108 Name of the host to look up in the dns.
109 Example value: www.example.org
111 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 Example value: 5
120 server
122 Name of the dns server to use.
123 Example value: ns1.someisp.net
125
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>
1322.8.2 2023-07-22 Smokeping_probes_DNS(3)