Skip to main content

Test Whether Failed Uptime Emails Are Retried

GuideWritten by oncall.fyi editorialPublication approved by Burak YApproval recorded 12 September 2026
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

TestEvidence to collect
Test SMTP connection refusedAttempt count and next attempt time
Test SMTP connection times outSend timeout and queue behavior
Relay returns temporary failureWhether and when retry occurs
Test authentication rejectedVisible error and bounded behavior
Relay accepts then delays deliveryAccepted timestamp versus inbox arrival
Monitor restarts while work is pendingWhether 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.

  1. RFC 5321 SMTP protocol IETF. Checked 12 September 2026.
  2. 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