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
| Type | What it checks | Good 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 page | A 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. |
| Ping | A 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 record | A 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 certificate | A host presents a valid certificate with enough days left. | Certificates on hosts or ports a website monitor does not cover. |
| Domain expiry | How many days a domain registration has left, read from the registry. | Not losing a domain because a renewal failed. |
| Third-party service | A 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.
Still stuck? Email [email protected] and say which guide you were following.