1Smokeping_probes_EchoPingHttp(3)   SmokePing  Smokeping_probes_EchoPingHttp(3)
2
3
4

NAME

6       Smokeping::probes::EchoPingHttp - an echoping(1) probe for SmokePing
7

OVERVIEW

9       Measures HTTP roundtrip times (web servers and caches) for SmokePing.
10

SYNOPSIS

12        *** Probes ***
13
14        +EchoPingHttp
15
16        binary = /usr/bin/echoping
17        forks = 5
18        offset = 50%
19        step = 300
20
21        # The following variables can be overridden in each target section
22        accept_redirects = yes
23        extraopts = -some-letter-the-author-did-not-think-of
24        ignore_cache = yes
25        ipversion = 4
26        pings = 5
27        port = 80
28        priority = 6
29        revalidate_data = no
30        timeout = 20
31        tos = 0xa0
32        url = /
33        waittime = 1
34
35        # [...]
36
37        *** Targets ***
38
39        probe = EchoPingHttp # if this should be the default probe
40
41        # [...]
42
43        + mytarget
44        # probe = EchoPingHttp # if the default probe is something else
45        host = my.host
46        accept_redirects = yes
47        extraopts = -some-letter-the-author-did-not-think-of
48        ignore_cache = yes
49        ipversion = 4
50        pings = 5
51        port = 80
52        priority = 6
53        revalidate_data = no
54        timeout = 20
55        tos = 0xa0
56        url = /
57        waittime = 1
58

VARIABLES

60       Supported probe-specific variables:
61
62       binary
63           The location of your echoping binary.
64
65           Default value: /usr/bin/echoping
66
67       forks
68           Run this many concurrent processes at maximum
69
70           Example value: 5
71
72           Default value: 5
73
74       offset
75           If you run many probes concurrently you may want to prevent them
76           from hitting your network all at the same time. Using the probe-
77           specific offset parameter you can change the point in time when
78           each probe will be run. Offset is specified in % of total interval,
79           or alternatively as 'random', and the offset from the 'General'
80           section is used if nothing is specified here. Note that this does
81           NOT influence the rrds itself, it is just a matter of when data
82           acqusition is initiated.  (This variable is only applicable if the
83           variable 'concurrentprobes' is set in the 'General' section.)
84
85           Example value: 50%
86
87       step
88           Duration of the base interval that this probe should use, if
89           different from the one specified in the 'Database' section. Note
90           that the step in the RRD files is fixed when they are originally
91           generated, and if you change the step parameter afterwards, you'll
92           have to delete the old RRD files or somehow convert them. (This
93           variable is only applicable if the variable 'concurrentprobes' is
94           set in the 'General' section.)
95
96           Example value: 300
97
98       Supported target-specific variables:
99
100       accept_redirects
101           The echoping(1) "-R" option: Accept  HTTP  status  codes  3xx
102           (redirections) as normal responses instead of treating them as
103           errors. Note that this option is only available starting with
104           Echoping 6.
105
106           Enabled if the value is anything other than 'no' or '0'.
107
108           Example value: yes
109
110       extraopts
111           Any extra options specified here will be passed unmodified to
112           echoping(1).
113
114           Example value: -some-letter-the-author-did-not-think-of
115
116       ignore_cache
117           The echoping(1) "-A" option: force the proxy to ignore the cache.
118           Enabled if the value is anything other than 'no' or '0'.
119
120           Example value: yes
121
122       ipversion
123           The IP protocol used. Possible values are "4" and "6".  Passed to
124           echoping(1) as the "-4" or "-6" options.
125
126           Example value: 4
127
128       pings
129           How many pings should be sent to each target, if different from the
130           global value specified in the Database section. Note that the
131           number of pings in the RRD files is fixed when they are originally
132           generated, and if you change this parameter afterwards, you'll have
133           to delete the old RRD files or somehow convert them.
134
135           Example value: 5
136
137       port
138           The TCP port to use.
139
140           Example value: 80
141
142       priority
143           The "-p" echoping(1) option.
144
145           Example value: 6
146
147       revalidate_data
148           The echoping(1) "-a" option: force the proxy to revalidate data
149           with original server. Enabled if the value is anything other than
150           'no' or '0'.
151
152           Example value: no
153
154       timeout
155           The "-t" echoping(1) option.
156
157           Example value: 20
158
159           Default value: 10
160
161       tos The "-P" echoping(1) option.
162
163           Example value: 0xa0
164
165       url The URL to be requested from the web server or cache. Can be either
166           relative (/...) for web servers or absolute (http://...) for
167           caches.
168
169           Default value: /
170
171       waittime
172           The "-w" echoping(1) option.
173
174           Example value: 1
175

AUTHORS

177       Niko Tyni <ntyni@iki.fi>
178

NOTES

180       You should consider setting a lower value for the "pings" variable than
181       the default 20, as repetitive URL fetching may be quite heavy on the
182       server.
183
184       The fill, size and udp EchoPing variables are not valid for
185       EchoPingHttp.
186

SEE ALSO

188       Smokeping::probes::EchoPing, Smokeping::probes::EchoPingHttps
189
190
191
1922.7.3                             2021-03-11  Smokeping_probes_EchoPingHttp(3)
Impressum