Authentik: know when the front door is about to shut
New Authentik integration (read-only, every 5 minutes): version, workers, outposts and their health, certificates and API tokens that expire, failed sign-ins and configuration errors. Monitoring -> Authentik page. Alerts: an outpost that serves apps has gone quiet (critical), certificate or token about to run out (critical close to it), no worker, failed sign-ins, configuration errors. Held by maintenance, held when unreadable, in /metrics. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
0146eb8bca
commit
aebe98bf15
33 files changed
+8050
-7
No files matched your search
@@ -13,6 +13,7 @@ This page explains what Homelab Manager watches, how often, how a problem become
|
||||
- [Service levels](#service-levels)
|
||||
- [Your own alert rules](#your-own-alert-rules)
|
||||
- [Duplicati backups](#duplicati-backups)
|
||||
- [Authentik](#authentik)
|
||||
- [Jellyfin](#jellyfin)
|
||||
- [Docker containers that are broken](#docker-containers-that-are-broken)
|
||||
- [Endpoint checks and heartbeats](#endpoint-checks-and-heartbeats)
|
||||
@@ -130,6 +131,7 @@ Every threshold here is a default; where it can be changed, the place is named.
|
||||
| **Restore test** | A restore test failed, or none has been done within the window | failure always; age off by default | Settings → Notifications |
|
||||
| **Expiry** | A secret, certificate, domain or Tailscale key is within its warning window or has expired | per item (domains 30 days) | the item; Settings → Notifications |
|
||||
| **Docker updates** | A container image has a newer version | | Settings → Notifications |
|
||||
| **Authentik needs a look** | An outpost that serves apps has gone quiet (critical), a certificate or API token is about to run out (critical close to it), no worker is connected, or sign-ins or flows are failing | on, with the integration | Authentik page; [below](#authentik) |
|
||||
| **Jellyfin needs a look** | Jellyfin wants a restart, a scheduled task (a library scan) failed, or 10 or more sign-ins failed in a day | on, with the integration | Jellyfin page; [below](#jellyfin) |
|
||||
| **Duplicati backup failed / overdue** | A backup's last run failed (critical from the second in a row), or it has not succeeded for longer than it should | per job (2 days by default) | Duplicati page; [below](#duplicati-backups) |
|
||||
| **Docker container broken** | A container keeps restarting (critical), is unhealthy, stopped unexpectedly, or was created and never started; or Dockhand cannot reach a Docker host | on | Settings → Notifications; [below](#docker-containers-that-are-broken) |
|
||||
@@ -213,6 +215,23 @@ and one that no longer exists can be **forgotten** (with its history; if Duplica
|
||||
What is kept: the last result of each job, and each report for 400 days or 400 reports. `/metrics` has `homelab_duplicati_backup_ok`, `homelab_duplicati_last_success_age_seconds` and `homelab_duplicati_source_size_bytes` for each job. A job is only learned from its first report, so a job that has
|
||||
*never* reported is not known to be missing; and because the reports are pushed, **the app being down when a backup finishes** loses that report (the backup shows as overdue only once it is).
|
||||
|
||||
## Authentik
|
||||
|
||||
An integration of type *Authentik* ([INTEGRATIONS.md](../INTEGRATIONS.md#authentik)) is read every five minutes, and **Monitoring → Authentik** shows its version, workers, each outpost (and whether it is reporting), the certificates and API tokens that run out — soonest first — and the failed sign-ins of the last day.
|
||||
Authentik is the front door to everything behind it, so what is raised early is what would shut it:
|
||||
|
||||
| Alert | When | Severity |
|
||||
|---|---|---|
|
||||
| **Outpost has not reported in** | An outpost that serves applications had no instance report within five minutes | critical |
|
||||
| **Outpost runs another version** | An instance runs a version other than the one Authentik expects | warning |
|
||||
| **Certificate runs out** | Within 14 days (a certificate Authentik renews itself is left out) | warning; critical within 3 days and after |
|
||||
| **API token or app password runs out** | Within 7 days | warning; critical within 2 days. The token this app reads Authentik with counts too |
|
||||
| **No worker connected** | The workers endpoint answers with none | warning |
|
||||
| **Failed sign-ins** | 20 or more in the last day | warning |
|
||||
| **Configuration errors** | 3 or more in the last day, with the newest message | warning |
|
||||
|
||||
Maintenance on the integration holds them. A reading older than 20 minutes is not believed: nothing is raised or cleared from it, and the Alerts page says Authentik could not be checked. A token that does not expire, a verification token (they live for minutes) and an outpost with no applications are never alerts.
|
||||
|
||||
## Jellyfin
|
||||
|
||||
An integration of type *Jellyfin* ([INTEGRATIONS.md](../INTEGRATIONS.md#jellyfin)) is read every two minutes, and **Monitoring → Jellyfin** shows whether it is up, who is **streaming** right now (and whether that is transcoded, which is what loads the machine), the scheduled tasks that failed, and a chart of the most that were streaming at once.
|
||||
|
||||
Reference in new issue
Block a user