# 04 — Monitoring Push (boka → Webspace)

**Priorität:** medium  
**Status:** erledigt (2026-06-12)  
**Abhängigkeiten:** 01, 03 (ingest + stale-Check)  
**Siehe auch:** [`../MONITORING.md`](../MONITORING.md) Ebene 2

## Ziel

Interne Metriken von boka an 0012.de pushen; Alarm wenn kein Push seit 15 Min.

## Checkliste

### Webspace

- [x] `public/ingest.php` — POST JSON, Token-Prüfung (`MONITOR_INGEST_TOKEN`) + IP-Whitelist (`BOKA_IP`)
- [x] Payload speichern: `private/data/boka-status.json` + Timestamp
- [x] In `monitor.php`: wenn `last_push` > 15 Min → Alarm „boka silent“
- [x] Schwellen: `disk_percent > 85`, `containers_unhealthy > 0`
- [x] Backup-Heartbeat-Feld `backup_last_success` — Alarm wenn > 25h alt (nur wenn Feld gesetzt)

### boka

- [x] Skript `~/server/scripts/push-status.sh`
- [x] Sammelt: load, disk %, mem, `docker ps` running/unhealthy
- [x] POST an `INGEST_URL` mit curl
- [x] Crontab: `*/5 * * * *`
- [ ] Nach erfolgreichem Backup: Push mit aktualisiertem `backup_last_success` (wenn Backups existieren)

### Token

- [x] Starkes Token in `.env` / `server.env`
- [x] Identisch in boka `~/server/config/push.env` (`PUSH_TOKEN`)

## Beispiel-Payload

```json
{
  "token": "...",
  "load": [1.2, 0.8, 0.5],
  "disk_percent": 55,
  "mem_available_mb": 4700,
  "containers_running": 38,
  "containers_unhealthy": 0,
  "backup_last_success": "2026-06-10T03:00:00+02:00"
}
```

## Akzeptanzkriterien

- [x] Push von boka aktualisiert JSON auf Webspace (HTTP 200, 2026-06-12)
- [x] Stale-Alarm — Logik in `monitor-lib.php`; Live-Test bewusst übersprungen

## Notizen

- Skript liegt im **boka-Repo** (`~/server`); Webspace-Repo: `ingest.php` + `monitor-lib.php`
- SSH-Sync: `frank@frank-schwenk.de` — push.env, Crontab, `webspace/`-Kopien
- Bugfix in `push-status.sh`: Env-Vars müssen **vor** `python3` stehen (nicht danach)
- boka-Agent: verifiziert (grünes Licht)
- Gitea-Remote für `~/server`: später (User)
- Backup-Hook in `push-status.sh`: offen bis Backups existieren