Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GDNSD-PLUGIN-HTTP_STATUS(8)	      gdnsd	     GDNSD-PLUGIN-HTTP_STATUS(8)

NAME
     gdnsd-plugin-http_status - gdnsd HTTP monitoring plugin

SYNOPSIS
     Example http_status service_types config:

       service_types => {
	 webcheck => {
	   plugin => http_status,
	   port => 8080,	     # default 80
	   url_path => /checkme      # default '/'
	   vhost => www.example.com  # default none
	   ok_codes => [ 200, 301 ], # default [ 200 ]
	   up_thresh => 20,
	   ok_thresh => 10,
	   down_thresh => 10,
	   interval => 10,
	   timeout => 3,
	 }
       }

DESCRIPTION
     gdnsd-plugin-http_status is a monitoring plugin that checks basic HTTP ser-
     vice.

PARAMETERS
     portThe numeric port number to connect on, default 80.

     url_path
	 The string URL to GET from the remote service, default "/"

     vhost
	 The string hostname to supply as a "Host:" header with the request.  No
	 default.  If unspecified, no "Host:" header is sent at all.

     ok_codes
	 An array of integer HTTP status codes which are acceptable as positive
	 responses.  The default is "[ 200 ]".

SEE ALSO
     gdnsd.config(5), gdnsd.zonefile(5), gdnsd(8)

     The gdnsd manual.

COPYRIGHT AND LICENSE
     Copyright (c) 2014 Brandon L Black <blblack@gmail.com>

     This file is part of gdnsd.

     gdnsd is free software: you can redistribute it and/or modify it under the
     terms of the GNU General Public License as published by the Free Software
     Foundation, either version 3 of the License, or (at your option) any later
     version.

     gdnsd is distributed in the hope that it will be useful, but WITHOUT ANY
     WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
     FOR A PARTICULAR PURPOSE.	See the GNU General Public License for more de-
     tails.

     You should have received a copy of the GNU General Public License along
     with gdnsd.  If not, see <http://www.gnu.org/licenses/>.

gdnsd 3.8.0			   2026-08-01	     GDNSD-PLUGIN-HTTP_STATUS(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gdnsd-plugin-http_status&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help