Skip to content
HonkWatch
PricingLocationsHonk RadarHelpAPI Log inGet started
All help topics

Getting started

  • Getting started
  • How checks work

Monitors

  • Which monitor to use
  • Website monitor
  • API monitor
  • Keyword monitor
  • Ping monitor
  • Port monitors (TCP and UDP)
  • DNS monitor
  • SSL certificate monitor
  • Domain expiry monitor
  • Third-party services
  • Page load monitor
  • Heartbeat monitor (cron jobs)
  • Maintenance windows
  • Incidents

Alerts

  • Setting up alerts
  • Email alerts
  • Slack
  • Microsoft Teams
  • Discord
  • Telegram
  • PagerDuty
  • ntfy
  • Webhooks
  • Zapier

Phone and desktop app

  • The phone and desktop app
  • App alerts not arriving

Status pages

  • Status pages
  • Status page on your own domain

Team and account

  • Team members
  • Plans and limits
  • API keys and the API
  • Your account

Troubleshooting

  • A monitor says down but my site works
  • I did not get an alert
  • Allowing our checks through a firewall
  • Questions and answers

Help / Monitors

Which monitor to use

HonkWatch has twelve monitor types. You pick one under "What should we watch?" when you press Add monitor. This page puts them side by side so you can choose the one that fits.

The twelve types

TypeWhat it checksGood for
Website (HTTP/HTTPS)A web address answers with a good status code, within the timeout.Most websites and web apps. Start here if you are unsure.
API (JSON reply)An address answers with JSON, and optionally that one value in it is what you expect.Health endpoints and APIs.
Keyword on pageA word or phrase is in the page's HTML, or is not.Pages that can break while still answering, out-of-stock notices, error messages.
PingA server answers ping. We send 3 pings; one reply is enough.Servers, routers and other devices.
Port (TCP)A connection opens on a port.Mail servers, databases, SSH, anything that listens on TCP.
Port (UDP)A packet sent to a port gets a reply.Game servers, DNS, NTP, VoIP.
DNS recordA name resolves, optionally to an answer you expect, and tells you when the answer changes.Making sure a domain still points the right way.
SSL certificateA host presents a valid certificate with enough days left.Certificates on hosts or ports a website monitor does not cover.
Domain expiryHow many days a domain registration has left, read from the registry.Not losing a domain because a renewal failed.
Third-party serviceA service's official status page.Services you depend on but do not run, such as your payment or cloud provider.
Page load (full page)The page plus the stylesheets, scripts, images and icons named in its HTML: total time and size.Finding slow pages and broken files.
Heartbeat (cron job)Your job calls a link we give you. No call in time means down.Backups, cron jobs and scripts, and servers we cannot reach from outside.

Choosing between similar types

Website, keyword or API?

All three make a web request and check the status code. A website monitor stops there. A keyword monitor also reads the page and looks for your text. An API monitor also reads the reply as JSON and can compare one value.

A site can answer "200 OK" while showing an error page or an empty shop. If that worries you, use a keyword monitor and look for something that is only there when the page really works.

Website or page load?

A website monitor makes one request for the page itself. A page load monitor also fetches the files named in the page's HTML (up to 50), so it shows the full load time, the page size and how many files failed. It does not run the page in a browser, so files that scripts load later are not counted. It is heavier, so it has limits: it runs at most every 5 minutes, and you can have up to 20 page load monitors per account and 2 per site. For plain up or down, use a website monitor.

Ping or port?

Ping tells you the machine is reachable. A port monitor tells you a service on it is listening. A server can answer ping while its database or mail service is stopped, and some servers do not answer ping at all. If you care about a service, watch its port.

SSL certificate or website?

A website monitor on an https:// address already reads the certificate and warns you before it expires (14 days by default). Use an SSL certificate monitor when the certificate is on another port, such as a mail server, or when you want an expiring certificate to count as down rather than as a warning.

Heartbeat or the rest?

Every other type is us checking you from outside. A heartbeat works the other way round: your job tells us it ran. Use it for things that have no address to check, or that sit behind a firewall.

Limits that apply to all types

  • Every type except heartbeat needs a public internet address. Private and internal addresses are refused.
  • Third-party service monitors have their own allowance, separate from your other monitors. The numbers for each plan are in Plans and limits.
  • Until you confirm your email address you can have 3 monitors.

Changing type later

You can change a monitor's type: open the monitor from Monitors, press Edit, pick another type and press Save changes. The fields on the form change to match the type you pick. If you move a monitor to or from the third-party type, it has to fit in the other allowance.

Still not sure?

Start with a website monitor on your home page. It covers most outages. You can add a keyword or port monitor later when you know what tends to break. How checks work explains what all types have in common.

← How checks work Website monitor →

Still stuck? Email [email protected] and say which guide you were following.