Add Hetzner Robot: dedicated servers and storage boxes, with shutting-down, locked and rescue-left-on alerts
Read every 15 minutes (Robot allows 200 requests an hour; read-only): each server's product, addresses, status, rescue system and paid-until, and the storage boxes. Adapter, sync service, hetzner_robot_state table, /api/hetzner-robot, Infrastructure → Hetzner Robot page, metrics and docs. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
7618bf0f0a
commit
01acbaf831
31 files changed
+10105
-10
No files matched your search
@@ -15,6 +15,7 @@ This page explains what Homelab Manager watches, how often, how a problem become
|
||||
- [Duplicati backups](#duplicati-backups)
|
||||
- [Nextcloud](#nextcloud)
|
||||
- [Hetzner Cloud](#hetzner-cloud)
|
||||
- [Hetzner Robot](#hetzner-robot)
|
||||
- [Game servers (Fragnet)](#game-servers-fragnet)
|
||||
- [Media managers](#media-managers-sonarr-radarr-prowlarr)
|
||||
- [Download clients](#download-clients-qbittorrent-sabnzbd)
|
||||
@@ -149,6 +150,7 @@ Every threshold here is a default; where it can be changed, the place is named.
|
||||
| **Nextcloud can't be used / disk low** | The database needs upgrading (critical), maintenance mode is on, or little room is left for the data (critical under 5 GB) | on, with the integration | Nextcloud page; [below](#nextcloud) |
|
||||
| **Hetzner server off / traffic / rescue / backup** | A Hetzner Cloud server that was running is off, is stuck migrating or rebuilding, has used 80% of its month's traffic (critical at 100%), has rescue mode left on, or has backups enabled but none recent | on, with the integration | Hetzner page; [below](#hetzner-cloud) |
|
||||
| **Sonarr / Radarr / Prowlarr** | An application reports a health warning or error, has downloads stuck for two hours, or a disk under 10% free | on, with the integration | Media managers page; [below](#media-managers-sonarr-radarr-prowlarr) |
|
||||
| **Hetzner Robot** | A dedicated server or storage box is cancelled and ends within 30 days (critical within 7), a storage box is locked (critical), a rescue system has been on for two hours, or a server is still "in process" after a day | on, with the integration | Hetzner Robot page; [below](#hetzner-robot) |
|
||||
| **qBittorrent / SABnzbd** | Downloads stuck (an error, or stalled for a day), qBittorrent without a network for 15 minutes, SABnzbd paused for six hours with work waiting or downloading nothing for an hour, or a download disk nearly full | on, with the integration | Download clients page; [below](#download-clients-qbittorrent-sabnzbd) |
|
||||
| **AdGuard Home** | DNS has not answered for ten minutes, or its DNS server is not running (critical); protection left off for an hour, or filter lists not updated for a week | on, with the integration | AdGuard Home page; [below](#adguard-home) |
|
||||
| **Technitium DNS** | DNS has not answered for ten minutes, or a secondary zone has expired (critical); a zone cannot sync, blocking left off for an hour, or block lists overdue for an update (warning) | on, with the integration | Technitium DNS page; [below](#technitium-dns) |
|
||||
@@ -292,6 +294,19 @@ Hetzner does not say when a server went off or when rescue mode was switched on,
|
||||
|
||||
**On a server's page**, a *Hetzner Cloud* card appears when one of the project's servers is that server — matched by its public or private address, else by name — with its status, type, newest backup and traffic. A Hetzner server with no agent is listed as *not in the app's servers*. `/metrics` has `homelab_hetzner_server_running`, `homelab_hetzner_traffic_outgoing_bytes`, `homelab_hetzner_traffic_included_bytes` and `homelab_hetzner_monthly_cost`.
|
||||
|
||||
## Hetzner Robot
|
||||
|
||||
An integration of type *Hetzner Robot* ([INTEGRATIONS.md](../INTEGRATIONS.md#hetzner-robot)) is one Hetzner account's dedicated servers and storage boxes, read every fifteen minutes (Robot allows 200 requests an hour), and **Infrastructure → Hetzner Robot** shows them: each server's product, data centre, addresses, traffic plan, status, rescue system and what is paid until (or, if cancelled, when it ends and how many days are left), and each storage box's product, location, linked server, whether it is locked and what is paid until. Nothing is reset, ordered or cancelled.
|
||||
|
||||
| Alert | When | Severity |
|
||||
|---|---|---|
|
||||
| **Shutting down** | A server (or storage box) is **cancelled** and its last day is within **30 days**. The date Robot gives is the last day it runs; the server and its data go with it. Not-cancelled ones are never raised, however near their renewal | warning; critical within 7 days |
|
||||
| **Storage box locked** | A storage box is locked — its data cannot be reached | critical |
|
||||
| **Rescue system left on** | A server's rescue system has been switched on, in every read, for **two hours**: its next boot is into the rescue system, not its own | warning |
|
||||
| **Stuck being set up** | A server has been something other than "ready" ("in process") in every read for **a day** | warning |
|
||||
|
||||
"Since when" is what the app saw: the time of the first read that showed it, carried from read to read. Maintenance on the integration holds the alerts; a reading older than 45 minutes is not believed (they are neither raised nor cleared, and the Alerts page says it could not check). A server's rescue state that could not be asked is *unknown*, not off, and raises nothing.
|
||||
|
||||
## Media managers (Sonarr, Radarr, Prowlarr)
|
||||
|
||||
An integration of type *Sonarr*, *Radarr*, *Prowlarr*, *Lidarr* or *Readarr* ([INTEGRATIONS.md](../INTEGRATIONS.md#sonarr-radarr-and-prowlarr)) is read every five minutes, and **Apps → Media managers** shows, for each: what the application says is wrong with itself, its download queue (the stuck ones first, with why), its disks, how many wanted items have no file (Sonarr, Radarr) and, for Prowlarr, which indexers it has switched off after failures. Nothing is searched, grabbed or changed.
|
||||
|
||||
Reference in new issue
Block a user