Checks
A check is one thing ZeroDrop watches, probed from every active location on a fixed interval. There are two types: HTTP/HTTPS and SMTP. This page covers every field; for how results become an up/down verdict, see Consensus & status.
Common options
These apply to both check types.
| Option | Default | Notes |
|---|---|---|
| Name | required | A label for the check. Must be unique within your account. |
| Enabled | on | Turn a check off to stop probing without deleting it. |
| Interval | 60 s | How often each location probes. 60 seconds is the minimum. |
| Timeout | 5 s | A probe that takes longer than this is recorded as a failure. |
| Locations | all | Every check runs from all active locations. There's no per-check picker. |
| Public badges | off | Publish status, uptime and SSL badges for this check. See Dashboards. |
Your account has a maximum number of checks and a minimum interval. Both are shown on the Settings page and can be raised on request.
HTTP / HTTPS checks
An HTTP check requests a URL and decides success from the response.
| Option | Default | Notes |
|---|---|---|
| URL | required | The full http(s):// URL to request. |
| Method | GET |
Any standard HTTP method. |
| Expected status | 200 |
The probe fails if the final response status differs. |
| Body pattern | none | Optional substring that must appear in the response body. |
| Follow redirects | on | When off, a 3xx is the final response (useful to assert a redirect). |
| Max redirects | 5 | How many hops to follow before giving up. |
TLS certificate options (HTTPS)
For https:// URLs you can also control how the certificate is treated:
| Option | Default | Notes |
|---|---|---|
| SSL certificate must validate | on | The server's certificate must chain to a trusted root and match the host. Turn this off to monitor a host with a self-signed or otherwise untrusted certificate. |
| Fail when fewer days left than | 7 days | The check fails once the certificate has fewer than this many days of validity remaining, so you're alerted before it expires rather than after. Set it to Off to ignore expiry. |
On every probe ZeroDrop also records, for free:
- DNS time, time to first byte (TTFB) and total latency.
- The response size in bytes.
- For HTTPS, the TLS certificate chain: issuer, subject and days until expiry, so you can spot a certificate that's about to lapse.
Examples
- Health endpoint:
GET https://api.example.com/healthz, expected status200, body patternok. - Assert a redirect:
GET http://example.com, follow redirects off, expected status301. - Authenticated API liveness:
GET https://api.example.com/v1/models, expected status401. A401proves the API is up and enforcing auth.
SMTP checks
An SMTP check connects to a mail server, reads its welcome banner, and times how long that took.
| Option | Default | Notes |
|---|---|---|
| Host | required | The mail server hostname. |
| Port | 25 | Common choices: 25 (inbound MX), 587 (submission). |
| STARTTLS | on | When on, ZeroDrop issues EHLO + STARTTLS and inspects the TLS certificate. |
| Expected banner | none | Optional substring that must appear in the 220 greeting. |
The same TLS certificate options as HTTPS checks apply to the certificate presented during STARTTLS:
| Option | Default | Notes |
|---|---|---|
| SSL certificate must validate | on | The STARTTLS certificate must chain to a trusted root and match the host. Turn off for self-signed mail servers. |
| Fail when fewer days left than | 7 days | Alerts before the mail server's certificate expires. Set to Off to ignore expiry. |
The probe succeeds when the server answers with a 220 greeting (and, if
configured, the banner pattern matches and STARTTLS negotiates cleanly with a
certificate that passes the checks above). The headline metric for SMTP checks
is the welcome time: how quickly the banner arrived.
Editing and deleting
You can change any option on an existing check at any time; the new configuration takes effect on the next interval. Deleting a check removes it from every location and stops all of its alerts. The console asks you to confirm first.