Reference
Troubleshoot a monitor or notification
Start with the symptom you can see, then verify the monitor configuration, regional evidence, and delivery channel before escalating the issue.
A monitor stays unknown
- Confirm that the monitor is not paused or deleted and that it has at least one configured region.
- Check whether the problem affects one region or every configured region. A single-region gap can indicate a placement or target-network issue.
- If this is local development, start the full probe fleet with
docker compose --profile with-probe up -d. - For preview or production, contact the platform operator to verify the corresponding Fly.io probe app and machine health.
The Go probe is the component that polls endpoints and writes monitor status. Without a running probe, no new result can move a monitor out of unknown.
A failure looks like a false positive
- Open the incident and compare the confirming regions with the monitor's configured regions.
- Check whether the target firewall or WAF allow-lists all required probe sources.
- Review the monitor's response-time, status-code, keyword, or packet-loss threshold and adjust it only when the threshold reflects the service's expected behavior.
- Use the monitor's test-alert and test-recovery actions to verify delivery separately from the target failure.
An SSL warning appears
Confirm that the target is an HTTPS monitor and that SSL validation is enabled. Check the certificate chain, hostname, validity period, and the remaining expiry window. SSL validation is currently an HTTP monitor option, not a separate certificate monitor type.
A notification did not arrive
- Confirm that alerts are enabled and that the incident reached the configured confirmation threshold.
- Verify the destination address, webhook URL, signing secret, or PagerDuty routing key without pasting credentials into a support request.
- Check the channel's delivery history or provider logs, then send a test alert from the monitor.
- If recovery is the missing message, verify that recovery notifications are enabled and that the incident has resolved.