clawdie-ai/docs/public/sl/operate/monitoring.md
Sam & Claude faf060e0ce docs: introduce Layered Memory Fabric terminology (Sam & Codex)
Replaces public split-brain wording with Layered Memory Fabric, documents the skills/brain/ops planes, and sketches the shared FreeBSD/Linux install contract around PostgreSQL, ZFS/OpenZFS, and platform isolation adapters.\n\nChecks: npx --yes prettier@3 --check touched docs/html; git diff --check

---
Build: pass | Tests: FAIL — 1 failed
2026-06-13 21:32:50 +02:00

2 KiB

title description
Spremljanje Kako spremljati zdravje Clawdie sistema.

Spremljanje

Clawdie loči med "proces teče" in "sistem je zdrav". Primarni operatorjev ukaz za zdravje sistema je:

just doctor

Kaj preveri just doctor

  • stanje host procesa in zadnje heartbeate
  • zadnjo Telegram in pipeline aktivnost
  • zadnje uspehe in napake delovnih ječ
  • watchdog način, pomnilnik ter aktivne/čakajoče ječe
  • controlplane preverjanje storitev
  • stanje dnsmasq, listenerjev in razreševanja imen prek loopback in gateway resolverja
  • potek javnih TLS certifikatov za Clawdie in dokumentacijo
  • prisotnost acme.sh obnovitvenega crona (ACME_RENEWAL_CRON)
  • stanje razporejevalnika jutranjega poročila
  • stanje Layered Memory Fabric podatkovnih baz in uvoženega skills artefakta

Izhodna stanja

  • STATUS: ok - izhodna koda 0
  • STATUS: warn - izhodna koda 0
  • STATUS: error - izhodna koda 1

Manjkajoč ali zastarel vgrajeni knowledge artifact je opozorilo, ne popolna napaka zagona. Runtime lahko še vedno deluje, operator pa nato osveži ali znova uvozi artefakt.

Dodatni hitri pregledi

sudo service clawdie status
sudo tail -f /var/log/clawdie.log
sudo bastille list
df -h
top

DNS in jutranje poročilo

Od zadnjih sprememb just doctor posebej preverja:

  • ali dnsmasq posluša na 127.0.0.1 in na gateway naslovu warden0
  • ali se ai.home.arpa, cms.home.arpa, git.home.arpa in druga registrirana imena pravilno razrešijo
  • ali je naloga jutranjega poročila prisotna, ima pravilen cron izraz in smiseln next_run
  • ali se javni TLS certifikati približujejo poteku in ali obstaja acme.sh obnovitveni cron

To pomaga ujeti DNS razhajanja, tiha odstopanja razporejevalnika in pozabljene obnove certifikatov, ki jih sam PID procesa ne razkrije.

Priporočilo

Za operativno zdravje uporabljajte just doctor. Ročni ukazi kot top, df -h in pregled logov so dopolnilni pregledi, ne zamenjava za sistemski health check.