29 lines
1.6 KiB
Markdown
29 lines
1.6 KiB
Markdown
 
|
# AGENTS.md — threadnet-operating
|
||
|
|
|
||
|
|
> **Die Gruppenregeln sind kanonisch im `management`-Repo:**
|
||
|
|
> [`AGENTS.md`](https://git.lab/axion1337.chat/management/-/blob/main/AGENTS.md)
|
||
|
|
> — von außerhalb des Labs über den Gitea-Mirror lesbar:
|
||
|
|
> `https://rohana.axion1337.de/sorb/management`. Dort stehen Repo-Topologie und
|
||
|
|
> Mirror-Regeln, das Kanban-Framework (Status-Labels, WIP-Limit 2, ADR-Pflicht),
|
||
|
|
> Deploy-Übergabe und AAR-Verfahren, Secrets-Handhabung und die
|
||
|
|
> Karpathy-Leitlinien. Sie gelten für **jede** Session in diesem Repo.
|
||
|
|
> Hier steht nur, was zusätzlich für dieses Repository gilt.
|
||
|
|
|
||
|
|
## Was dieses Repo ist
|
||
|
|
|
||
|
|
Monitoring-Stack auf **CFGMON**: Prometheus, Loki, Grafana, Alloy, Alertmanager und der
|
||
|
|
CVE-Exporter — als Compose, **nicht** von Flux verwaltet. Deploy manuell auf dem Host
|
||
|
|
(`/opt/threadnet-operating/monitoring`).
|
||
|
|
|
||
|
|
## Was hier besonders zählt
|
||
|
|
|
||
|
|
- **Alarmregeln** liegen in `monitoring/prometheus/alerts.yml`; die Zustellung läuft über
|
||
|
|
`alertmanager/matrix-alerts.py` in den Matrix-Security-Raum. Eine Regel, die nie feuern
|
||
|
|
kann, ist schlimmer als keine — **fehlende Zeitreihen erzeugen Stille, keinen Alarm**
|
||
|
|
(deshalb die `or`-Fallbacks in `axion-backup`).
|
||
|
|
- **Config-Änderungen kommen nicht automatisch an.** Prometheus und Alertmanager mounten seit
|
||
|
|
2026-08-15 ihr Config-**Verzeichnis**; bei den übrigen Diensten (loki, alloy, die Skripte)
|
||
|
|
hängt der Einzeldatei-Mount weiter am Inode und braucht `--force-recreate` nach `git pull`.
|
||
|
|
Details und Prüfbefehl in `monitoring/README.md`.
|
||
|
|
- Ob eine Änderung wirklich greift, sieht man **nur im Container**, nie auf der Platte.
|