Test Whether Failed Uptime Emails Are Retried
Sources and verification
- Source dates
- Oldest source check: 12 September 2026.
- Technical verification
- Separate technical verification has not been recorded.
Publication approval and technical verification are recorded separately. Automated link checks establish reachability, not accuracy. A checked example verifies only its stated test cases, not the whole article or your production setup.
In short
Use a test monitor and a controlled SMTP destination to observe notification behavior when connection, authentication, or delivery fails. Record the original event, attempts, accepted message, and inbox arrival across recovery and a process restart. Do not infer durable retry from check retries. If needed, add a monitored persistent relay and an independent fallback for urgent alerts.
Key takeaways
- Probe retries and email delivery retries are separate mechanisms.
- A successful SMTP handoff does not guarantee immediate inbox arrival.
- Only a controlled restart test can establish whether queued work survives restart.
Scope the test to a disposable notification route
Record the Uptime Kuma version, deployment image, email integration settings, relay version, and provider. Create a test monitor with a clearly named test notification destination and an inbox you control. Tell the receiving participants when the exercise will run.
Use a controlled relay or network rule scoped only to that test route. Do not disconnect the production monitor's entire network or block the organization's real mail server to answer a retry question. Preserve application and relay logs with credentials removed.
Capture four different milestones
The useful timeline contains the target state change, each notification attempt, the relay's acceptance of the message, and the final inbox arrival. The SMTP protocol (opens in a new tab) distinguishes acceptance from later delivery. An application log saying that a send function ran establishes less than an SMTP acceptance response.
Check retry settings carefully. A setting that retries an HTTP monitor before declaring it down says nothing by itself about whether a failed email send is retried. Use the project's troubleshooting guidance (opens in a new tab) to gather the relevant errors for the installed release without assuming all integrations behave identically.
Run the failure matrix
| Test | Evidence to collect |
|---|---|
| Test SMTP connection refused | Attempt count and next attempt time |
| Test SMTP connection times out | Send timeout and queue behavior |
| Relay returns temporary failure | Whether and when retry occurs |
| Test authentication rejected | Visible error and bounded behavior |
| Relay accepts then delays delivery | Accepted timestamp versus inbox arrival |
| Monitor restarts while work is pending | Whether the original event survives |
For each case, trigger one down transition and one later recovery. Restore the test route and watch whether both arrive, in what order, and with their original observation times. Keep the experiment open for the documented retry horizon or a clearly recorded observation period. Seeing no retry for two minutes does not prove none can happen later.
Interpret the result narrowly
If email retries occur only in memory, a process restart may lose pending work. If the relay durably accepted the message first, the relay's queue may own later delivery. If no supported queue exists, a transient send failure may require a different integration or additional delivery component.
Document observed behavior for the specific combination tested. Avoid turning the result into an unsupported statement about every Uptime Kuma version or every SMTP provider. Re-run after notification-library or integration changes.
Add reliability only where the evidence requires it
A persistent relay can separate local acceptance from upstream availability, but it adds storage, authentication, retry, and operational responsibilities. Monitor its queue age, disk capacity, and expiry failures. Retain event keys so retries do not create duplicate incidents in downstream bridges.
For urgent failures, keep an independently tested alternative channel or an outside deadline heartbeat. A delayed down message followed immediately by recovery is useful history, but it may no longer be a useful page. Tie late delivery to a current-state view so the responder can distinguish an active problem from a recovered one.
Did this help?
Your answer helps us improve this guide. We save only the page and your choice for 30 days.
No name, email, or incident details are requested.
Sources
Vendor facts change. Each source below shows the date this page last checked it.
- RFC 5321 SMTP protocol — IETF. Checked 12 September 2026.
- Uptime Kuma troubleshooting — Uptime Kuma. Checked 12 September 2026.
Related
One practical idea, occasionally
The On-Call Brief: short field notes, templates, and operational lessons.
Follow the field guide
Email subscriptions are not open yet. Read new guides in your feed reader — no email address needed.
Subscribe with RSS