Skip to content
trace·warrior
Certificate labelled TLS with a ribbon seal, a target and an alert bell
updated · 2026-11-07

How to set up SSL certificate monitoring

Stop learning about expired TLS certs from support tickets. Set up SSL expiry monitoring in 30 seconds with the right thresholds and alerts.

securityTLSmonitoringTrace Warrior Team
7 min read

The number-one cause of "the site just stopped working" incidents is an expired TLS certificate that nobody noticed. The number-two cause is a renewed cert that was issued correctly but never reloaded by nginx / Apache / your load balancer.

Both are preventable with a one-time setup. This guide walks through configuring an SSL expiry monitor on Trace Warrior, picking the right thresholds, picking the right cadence, and routing the alert somewhere that will actually be seen.

What an SSL expiry monitor actually does

Once a day (by default), our worker runs a TLS handshake against your target, the same kind of check the SSL Certificate Checker runs, but from our monitoring servers rather than the London probe. It records the daysRemaining, the issuer, the protocol, and whether the chain is complete. When daysRemaining crosses a threshold, you get an email, and on Starter plans and above, a webhook posts the alert to Slack or Discord in their native formats, or to any HTTPS endpoint as HMAC-signed JSON.

Default thresholds are warning at ≤30 days, critical at ≤7 days. You can override these per monitor.

To see the numbers a monitor works from, run the checker by hand. This is the real result for our own tracewarrior.com on 7 November 2026, trimmed to the main fields:

VALID · 43d remaining
IPV4 · LONDON
216.150.16.129
handshake 18ms

TRUST       Trusted, and valid for tracewarrior.com.
SUBJECT     tracewarrior.com
ISSUER      YR1
VALID FROM  22 Sept 2026, 11:47 UTC
VALID TO    21 Dec 2026, 11:47 UTC
SANS        tracewarrior.com

CHAIN (3)
SUBJECT           ISSUER
tracewarrior.com  YR1
YR1               Root YR
Root YR           ISRG Root X1

That's a 90-day certificate with 43 days left and a complete chain, so a monitor with the default thresholds stays ok. In 13 days, if nothing has renewed it, it crosses the 30-day line and the warning fires.

Step 1. Open the new-monitor flow

Sign in and open /dashboard/monitors/new/ssl-expiry. Every plan includes monitoring; the Free tier covers 3 monitors with email alerts. If you're already at your plan's monitor limit, you'll be bounced back to the monitors index with an upgrade prompt; Starter at $9/month raises the limit to 15 and adds webhooks, with a 14-day free trial.

Step 2. Enter the target

The two required fields:

  • Hostname - the same name your browser hits. api.example.com, not https://api.example.com. Use the hostname users actually visit, not just the apex domain. A cert valid for example.com might not cover www.example.com (or vice versa).
  • Port - defaults to 443. Other ports you might monitor:
    • 465 - SMTPS (implicit TLS, recommended by RFC 8314 for mail submission)
    • 993 - IMAPS
    • 636 - LDAPS
    • 8443 - HTTPS on an alt port

For STARTTLS-style protocols (SMTP submission on 587, IMAP on 143), the SSL monitor's direct TLS handshake won't work. Those start in plaintext and upgrade. Monitor the direct-TLS variants instead.

Monitors don't run from the same place as the one-shot tools, so a 465 monitor works even though the SSL Certificate Checker can't test that port from its London probe. Port 25 is the exception: our monitoring servers' hosting provider blocks it outbound, so a port monitor on 25 is refused when you try to save it.

Step 3. Pick the thresholds

The defaults, 30 days warning, 7 days critical, are calibrated for the most common cert lifecycle: 90-day Let's Encrypt certificates renewed every 60 days.

Adjust them based on your renewal cadence:

Renewal cadenceWarningCriticalWhy
Automated, 60-day cron (Let's Encrypt + certbot)30 days7 daysIf you're at 30 days with no renewal, the cron is broken
Automated, managed (Cloudflare, Vercel, AWS ACM)14 days3 daysRenewal is fully managed; an alert means something's genuinely wrong
Manual (DigiCert, Sectigo, internal CA)60 days30 daysYou need lead time to procure + install, and public certs now last 200 days at most

Be honest about whose hands the renewal is in. If it's a human's responsibility, give them lead time.

Step 4. Pick the check interval

Default: daily. That's almost always right. SSL certs don't change on the minute, and a 24-hour gap between checks means the worst-case time-to-alert is 24 hours, still useful when your warning window is 30 days.

If you want sub-daily checks (every plan supports them: down to 10 minutes on Free, 5 on Starter, 1 minute on Professional and Enterprise), you can, but you're paying for it in monitor capacity. We'd recommend keeping SSL on daily and using the minute-level cadence on port and HTTP monitors instead.

Step 5. Pick the alert channels

Email is on by default. It routes to the email address on your Trace Warrior account, sent from alerts@tracewarrior.com. Subject line is [Trace Warrior · CRITICAL] <monitor name> - <summary> so it's filter-friendly.

Webhook is available on Starter and above. Drop in a URL and we'll POST to it on every alert. Slack and Discord webhook URLs are recognised automatically and get a native message; any other endpoint gets a JSON payload signed with an HMAC-SHA256 secret (revealed once when you save the monitor, so copy it then). Common targets:

  • Slack - paste a Slack Incoming Webhook URL (https://hooks.slack.com/...) and alerts arrive as a formatted message with a link to the monitor
  • Discord - paste a channel webhook URL and alerts arrive as an embed coloured by severity
  • PagerDuty - needs a small proxy of your own: point the webhook at it and have it turn our signed JSON into an Events API v2 event with your routing key (pasting a PagerDuty URL directly won't work, because PagerDuty rejects any payload in another format)
  • Your own listener - verify the X-TraceWarrior-Signature header before trusting the payload (how verification works)

The signed JSON payload for your own endpoint looks like this (trimmed):

{
  "event": "monitor.fired",
  "severity": "critical",
  "monitor": { "id": "...", "name": "...", "target": "api.example.com:443" },
  "check": { "state": "critical", "result": { "daysRemaining": 6 } },
  "previous_state": "ok"
}

A monitor.recovered event fires when the cert is renewed and the next check returns OK.

Step 6. Save and verify

Click Create monitor. If you set a webhook URL, a one-time secret reveal modal appears. Copy that secret somewhere safe; we don't show it again.

The first check runs immediately and you'll see a state pill: pending → first check → ok (or warning / critical if the cert is actually already in your alert window). The detail page shows the full check result, issuer, valid dates, SAN list, protocol, cipher.

Test the alerting path before you need it. Two ways:

  1. Run a known-broken target. Create a second SSL monitor against expired.badssl.com:443. The first check will fire a critical alert. Confirm the email + webhook landed. Delete the test monitor.
  2. Lower the threshold temporarily. Set warning days to a value above the cert's current daysRemaining. The next check transitions ok → warning and fires the alert. Restore the threshold.

If neither alert arrives, check that you saved your webhook secret correctly and that the email address on your account is reachable (no typos, not in spam).

Common SSL-monitoring mistakes

Monitoring the apex when users visit www. If your site uses www.example.com but you monitor example.com, you may be watching the apex-redirect cert (often Let's Encrypt) instead of the canonical site cert (often Cloudflare-managed). Always monitor the hostname users actually hit.

Setting warning days too low. If your renewal is manual and warning is set at 7 days, you won't have time to procure and install. Match the threshold to the human lead time, not the cert's technical TTL.

Monitoring only port 443 when you also run mail. SMTPS on 465 and IMAPS on 993 often have separate certs. Bounced mail because the SMTPS cert expired is a different incident from a broken website.

Ignoring the chain. The SSL monitor flags chainComplete: false in its result. If your server only serves the leaf cert (not the intermediates), modern browsers paper over it but older Java clients, IoT devices, and curl from old base images will break. Look at the result; don't just trust the state pill.

Not testing the alert path. A monitor that never alerts because the webhook signature is wrong or the email is in spam is worse than no monitor. False confidence. Fire a test alert deliberately on day one.

TL;DR

  1. Open /dashboard/monitors/new/ssl-expiry.
  2. Enter the hostname users actually visit + the port (443 for HTTPS).
  3. Set thresholds based on your renewal lead time. Default 30/7 is right for Let's Encrypt.
  4. Daily cadence is right for SSL.
  5. Enable email and, on Starter and up, a webhook to Slack, Discord, or your own HTTPS endpoint.
  6. Save → first check runs immediately.
  7. Test the alert path on day one against a known-broken target.

Recovery alerts fire automatically when the cert renews and the next check returns OK, so you'll know the rollout landed.

Related