Smokeping::probes::Curl - a curl(1)
probe for SmokePing
Fetches an HTTP or HTTPS URL using curl(1).
*** Probes ***
+Curl
binary = /usr/bin/curl forks = 5 offset = 50% step = 300
# The following variables can be overridden in each target section agent = User-Agent: Lynx/2.8.4rel.1 libwww-FM/2.14 SSL-MM/1.4.1 OpenSSL/0.9.6c extraargs = -6 --head --user user:password extrare = / / follow_redirects = yes include_redirects = yes insecure_ssl = 1 interface = eth0 pings = 5 ssl2 = 1 timeout = 20 urlformat = http://%host%/ # mandatory
# [...]
*** Targets ***
probe = Curl # if this should be the default probe
# [...]
+ mytarget # probe = Curl # if the default probe is something else host = my.host agent = User-Agent: Lynx/2.8.4rel.1 libwww-FM/2.14 SSL-MM/1.4.1 OpenSSL/0.9.6c extraargs = -6 --head --user user:password extrare = / / follow_redirects = yes include_redirects = yes insecure_ssl = 1 interface = eth0 pings = 5 ssl2 = 1 timeout = 20 urlformat = http://%host%/ # mandatory
(see curl(1)
for details of the options below)
Supported probe-specific variables:
Default value: /usr/bin/curl
Example value: 5
Default value: 5
Example value: 50%
Example value: 300
Supported target-specific variables:
curl(1)
option. This is a full HTTP User-Agent header including
the words ``User-Agent:''. Note that it does not need any quotes around it.
Example value: User-Agent: Lynx/2.8.4rel.1 libwww-FM/2.14 SSL-MM/1.4.1 OpenSSL/0.9.6c
Note that curl will be called with the resulting list of arguments without any shell expansion. If you need to specify any arguments containing spaces, you should set ``extrare'' to something else.
As a complicated example, to explicitly set the ``Host:'' header in Curl
requests, you need to set ``extrare'' to something else, eg. ``/;/'',
and then specify extraargs = --header;Host: www.example.com
.
Example value: -6 --head --user user:password
Example value: / /
Default value: / /
Example value: yes
Default value: no
Example value: yes
Default value: no
curl(1)
option. Accept SSL connections that don't have a secure
certificate chain to a trusted CA. Note that if you are going to monitor
https targets, you'll probably have to either enable this option or specify
the CA path to curl through extraargs below. For more info, see the
curl(1)
manual page.
Example value: 1
curl(1)
option. Bind to a specific interface, IP address or
host name.
Example value: eth0
Example value: 5
curl(1)
option. Force SSL2.
Example value: 1
curl(1)
option. Maximum timeout in seconds.
Example value: 20
Default value: 10
Example value: http://%host%/
This setting is mandatory.
Gerald Combs <gerald [AT] ethereal.com> Niko Tyni <ntyni@iki.fi>
You should consider setting a lower value for the pings
variable than the
default 20, as repetitive URL fetching may be quite heavy on the server.
The URL to be tested used to be specified by the variable 'url' in earlier versions of Smokeping, and the 'host' setting did not influence it in any way. The variable name has now been changed to 'urlformat', and it can (and in most cases should) contain a placeholder for the 'host' variable.
curl(1), http://curl.haxx.se/