Stan Runge
2bd668bf5e
All checks were successful
Deploy production / deploy (push) Successful in 2m39s
- home schema: home.links (seeded, owner-editable) and home.snapshots (written by a host collector) - deploy/home-collector: stdlib Python + systemd user timer (60s) that snapshots /proc stats, docker containers, systemd timers, service HTTP checks and ntfy topics via a limited role - extras/newtab-extension: MV3 new-tab override, zipped to static/newtab-extension.zip - owner-only pages skip Google Analytics; /trackers/health#body anchor for weigh-ins
32 lines
3.0 KiB
Markdown
32 lines
3.0 KiB
Markdown
# home-collector
|
|
|
|
Feeds the private dashboard at `/start` (also the browser new-tab page). The app container has
|
|
no Docker socket and must not get one, so a small stdlib-only Python script runs on the host
|
|
every minute (systemd **user** timer `home-collector.timer`) and upserts two rows into
|
|
`home.snapshots`:
|
|
|
|
| key | contents |
|
|
| ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
| `host` | CPU %, load, uptime, RAM, swap, disk; every Docker container (state, health, restart count, CPU/mem via `sudo docker`); systemd timers (`stan-backup*`, `postgres-backup*`, `disk-guard-*`, `house-scrape`, `b2-cost`, `groceries-import`, `money-sync`, `ned-collector-*`) with last/next run and result; HTTP up/down + latency for each self-hosted service; latest `~/backups-cost/daily/*.json` |
|
|
| `ntfy` | the last 40 messages (72 h) from the ntfy topics in `~/.config/disk-guard.env` (`NTFY_URL`) and `~/.config/house-scrape.env` (`HOUSE_NTFY_URL`), plus `NTFY_EXTRA`. Only a label is stored, never the topic name. |
|
|
|
|
The page reads both rows in the same parallel query batch as tasks and links, so a slow
|
|
upstream never delays it; a snapshot older than 3 minutes is shown as stale.
|
|
|
|
## Setup
|
|
|
|
1. A login role that may only upsert snapshots (created once, cluster superuser):
|
|
`CREATE ROLE home_collector LOGIN CONNECTION LIMIT 3 PASSWORD '…'; GRANT CONNECT ON DATABASE personal TO home_collector;`
|
|
The `home` migration grants `USAGE` on the schema and `SELECT, INSERT, UPDATE` on
|
|
`home.snapshots` when the role exists (re-run those two GRANTs by hand if the role is created later).
|
|
2. `~/.config/home-collector.env` (mode 600):
|
|
```
|
|
HOME_DB_URL=postgresql://home_collector:…@127.0.0.1:5440/personal
|
|
# optional extra topics, e.g. the backup alerts from /etc/stan-backup:
|
|
# NTFY_EXTRA=backups=https://ntfy.sh/<topic>
|
|
```
|
|
3. `bash deploy/home-collector/install.sh` (copies the script to `~/.local/bin/home-collector`
|
|
and enables the timer). Re-run after editing the script, e.g. to add a service to `SERVICES`.
|
|
|
|
Debug: `python3 ~/.local/bin/home-collector --print`, `journalctl --user -u home-collector -n 20`.
|