Add qBittorrent and SABnzbd: a Download clients page with stuck, disconnected, paused and full-disk alerts
Each client is read every five minutes (read-only; qBittorrent's sign-in is the only POST): speed, queue and item states, network connection or paused queue, free space, SABnzbd's failures and warnings. Shared adapter, sync service, download_state table, /api/downloads, metrics and docs. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
c7775e5dd9
commit
7618bf0f0a
32 files changed
+10715
-12
No files matched your search
@@ -17,6 +17,7 @@ This page explains what Homelab Manager watches, how often, how a problem become
|
||||
- [Hetzner Cloud](#hetzner-cloud)
|
||||
- [Game servers (Fragnet)](#game-servers-fragnet)
|
||||
- [Media managers](#media-managers-sonarr-radarr-prowlarr)
|
||||
- [Download clients](#download-clients-qbittorrent-sabnzbd)
|
||||
- [App versions](#app-versions)
|
||||
- [AdGuard Home](#adguard-home)
|
||||
- [Technitium DNS](#technitium-dns)
|
||||
@@ -148,6 +149,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) |
|
||||
| **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) |
|
||||
| **Grafana** | An alert rule is firing (critical when labelled critical or page), a rule cannot be evaluated, or a data source fails its health check | on, with the integration | Grafana page; [below](#grafana) |
|
||||
@@ -302,6 +304,22 @@ An integration of type *Sonarr*, *Radarr*, *Prowlarr*, *Lidarr* or *Readarr* ([I
|
||||
|
||||
Maintenance on the integration holds the alerts; a reading older than 20 minutes is not believed (they are neither raised nor cleared, and the Alerts page says it could not check). A finding is raised under a key made from the check and its words with the numbers left out, so "3 indexers unavailable" becoming "4" is the same alert, and different words are a new one.
|
||||
|
||||
## Download clients (qBittorrent, SABnzbd)
|
||||
|
||||
An integration of type *qBittorrent* or *SABnzbd* ([INTEGRATIONS.md](../INTEGRATIONS.md#qbittorrent-and-sabnzbd)) is read every five minutes, and **Apps → Download clients** shows, for each: how fast it is downloading (and, for qBittorrent, uploading), the items in its queue and their states (the ones needing a look first), whether qBittorrent can reach the network or SABnzbd is paused, the room its download folder has, what failed in the last day (SABnzbd) and SABnzbd's own warnings. Nothing is added, paused, resumed or removed.
|
||||
|
||||
| Alert | When | Severity |
|
||||
|---|---|---|
|
||||
| **Downloads stuck** | A download is in an **error** state (qBittorrent's `error` and `missingFiles`), or is **stalled** — nobody to get it from — with nothing having moved for **a day** (its last activity, or when it was added). One alert for all of a client's, naming the first three and why for the worst | warning |
|
||||
| **No connection** | qBittorrent has torrents loaded and has said `disconnected` in every read for **15 minutes** — typically a VPN it is bound to has dropped. `firewalled` (no incoming connections) is shown, not raised: it still downloads | warning |
|
||||
| **Paused and forgotten** | SABnzbd's whole queue has been paused for **six hours** with downloads waiting | warning |
|
||||
| **Downloading nothing** | SABnzbd is not paused, has downloads waiting, and its speed has been zero for **an hour** — a news server that does not answer or refuses the login | warning |
|
||||
| **Disk nearly full** | A download folder has under **10%** free (SABnzbd, which says how big its disks are), critical under 5%; or, for qBittorrent, which says only what is free, under **20 GB**, critical under 5 GB. A disk under 2 GB is not a download disk | warning; critical under 5% / 5 GB |
|
||||
|
||||
"Since when" is what the app saw: the time of the first read that showed it, carried from read to read, so a restart of the app does not start the clock again. A failed download in SABnzbd's history is shown for the last day, not raised: failures are normal on Usenet, and Sonarr and Radarr try another release (they raise it themselves when downloads stay stuck — see [Media managers](#media-managers-sonarr-radarr-prowlarr)).
|
||||
|
||||
Maintenance on the integration holds the alerts; a reading older than 20 minutes is not believed (they are neither raised nor cleared, and the Alerts page says it could not check).
|
||||
|
||||
## Game servers (Fragnet)
|
||||
|
||||
An integration of type *Fragnet game servers* ([INTEGRATIONS.md](../INTEGRATIONS.md#fragnet-game-servers)) is one account on Fragnet's game panel (a Pterodactyl fork), read every five minutes, and **Infrastructure → Game servers** shows its servers: the game, every address and port, whether it runs, memory and disk against the plan, the newest backup, and (opened) the backups, schedules and SFTP address. Operators can start, stop, restart and kill a server there.
|
||||
|
||||
Reference in new issue
Block a user