GDNSD-PLUGIN-HTTP_STATUS(8)

💖 GDNSD-PLUGIN-HTTP_STATUS 💖

okay bestie, so this is gdnsd-plugin-http_status — a gdnsd HTTP monitoring plugin. it literally just peeks at basic HTTP services and goes "yeah that's up" or "no ma'am". simple, iconic, does what it says on the tin. 🎀

---

✨ SYNOPSIS ✨

here's what an http_status service_types config looks like, in all its glory:

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,
  }
}

(no cap, those up_thresh / ok_thresh / down_thresh / interval / timeout lines are in the example, they're just not in the params list below — iykyk 🫶)

---

🌸 DESCRIPTION 🌸

gdnsd-plugin-http_status is a monitoring plugin that checks basic HTTP service. that's the whole vibe. it checks, it reports, it slays. 💅

---

🦋 PARAMETERS 🦋

• port — the numeric port number you're connecting on. default is 80.
• url_path — the string URL to GET from the remote service. default is "/".
• vhost — the string hostname to hand over as a "Host:" header with the request. no default. if you don't specify it, no "Host:" header gets sent at all. like, zero. none. 🙈
• ok_codes — an array of integer HTTP status codes that count as positive responses. default is [ 200 ].

---

👑 SEE ALSO 👑

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

the gdnsd manual. (go read it, bestie, it's giving ✨comprehensive✨)

---

💜 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 details.

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

---

🧚 and that's the whole page! you ate that.

✧･ﾟ gdnsd 3.8.3 — 2025-02-16 — GDNSD-PLUGIN-HTTP_STATUS(8) ･ﾟ✧ 💖✨🎀