Add address aliases for the Uptime Kuma maintenance sync, and ignore Kuma's "null"

Uptime Kuma often watches a host by another address than the one it was added
with here (a Proxmox host monitored over Tailscale, say). Address aliases on
the Maintenance page say that an address belongs to a server, integration or
DNS provider, so the sync puts the window there; matching stays exact.
Migration 0018 adds maintenance_aliases.

Also fixes monitors whose empty hostname/URL/port arrive from Kuma's metrics as
the text "null": they were taken as an address, hiding the real URL.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
bobbanandClaude Sonnet 5.5 committed 2026-10-13 20:25:57 +02:00
1 parent 3e6404371b
commit 44cc9d1cf2
12 files changed
+2239 -14

No files matched your search

+5 -2
View File
@@ -93,8 +93,11 @@ the dashboard views themselves load fine.
that hasn't started shows as *Scheduled* and silences nothing yet.
- Matching is exact. Nothing is worked out through DNS, so a website that only resolves to the same address
as a reverse proxy does not put the proxy into maintenance. A monitor that matches nothing is listed in the
result as `name (address)` so you can see why. The usual fix is to make the address agree: a Proxmox
integration added by IP will not match a monitor that watches its hostname, and vice versa.
result as `name (address)` so you can see why. The usual cause is that Uptime Kuma watches a thing by a different
address than the one it was added with here (a Proxmox host added by its LAN address but monitored over Tailscale).
Add that address under **Address aliases** on the Maintenance page, saying which server, integration or DNS
provider it belongs to; matching stays exact, and an alias applies to every sync. Monitors that are not in
Uptime Kuma's metrics (paused ones) and hosted services outside your network can't be matched and are left alone.
- A window on an integration silences that integration's alerts, including "integration down" for that
type of service — see the Maintenance page for the full list.
- Tick *Keep maintenance windows in step with Uptime Kuma's schedule* to run this automatically every