Der System-Tab umfasst Infrastruktur und Betrieb: Web-Einstellungen, Mail-Benachrichtigungen,
Health-Monitoring, Backup & Restore, Performance-Cache, Integritaetspruefung, Selbsttest
und das Aenderungsprotokoll. Er ist in 8 Sub-Tabs gegliedert.
Sub-Tab: Web
Netzwerkeinstellungen fuer die Web-Oberflaechen. Aenderungen an Host und Ports
erfordern einen Neustart der Services.
Feld
Typ
Standard
Beschreibung
Empfehlung
Host
Text
0.0.0.0
Bind-Adresse. 0.0.0.0 = alle Interfaces.
Standard belassen. Nur aendern, wenn der Dienst nur auf einem bestimmten Interface erreichbar sein soll.
Port (Chat-UI)
Zahl
8501
Port der Benutzer-Chat-Oberflaeche.
Standard belassen.
Admin-Port
Zahl
8502
Port der Admin-Oberflaeche.
Standard belassen.
Achtung: Nach Port-Aenderungen muessen die systemd-Services
(kiara.service, kiara-admin.service) neu gestartet werden.
Firewall-Regeln entsprechend anpassen.
Sub-Tab: Mail
SMTP-Konfiguration fuer Admin-Benachrichtigungen. Das System sendet Mails bei Ausfaellen
(Ollama, Datenquellen) und optionale Statusberichte.
SMTP-Server
Feld
Typ
Standard
Beschreibung
Empfehlung
Server
Text
—
SMTP-Server-Adresse.
Beispiel: smtp.firma.de
Port
Zahl
587
SMTP-Port.
587 (STARTTLS) oder 465 (SSL). 25 nur im internen Netz.
Verschluesselung
Dropdown
starttls
none, starttls, ssl.
starttls empfohlen.
Anmeldung
Feld
Typ
Beschreibung
Benutzername
Text
SMTP-Login (oft die E-Mail-Adresse).
Passwort
Passwort
Wird verschluesselt gespeichert. Maskiert bei erneutem Laden.
Benachrichtigung wenn der Ollama-Server nicht antwortet.
Datenquelle nicht erreichbar
An
Benachrichtigung wenn eine Datenquelle (SMB, WebDAV, ...) nicht erreichbar ist.
Indexierungsfehler
An
Benachrichtigung bei fehlgeschlagenen Ingestion-Jobs.
Status-Reports
Feld
Standard
Beschreibung
Automatische Status-Reports
Aus
Sendet periodisch einen zusammenfassenden Bericht per Mail.
Intervall
weekly
daily, weekly, monthly.
Aktionen
Button
Beschreibung
Speichern
Speichert die Mail-Konfiguration.
Test-Mail senden
Sendet eine Test-Nachricht an die konfigurierten Empfaenger.
Status-Report senden
Sendet sofort einen Status-Report (unabhaengig vom Intervall).
Konfiguration loeschen
Entfernt die gesamte Mail-Konfiguration. Keine Mails mehr.
Tipp: Nach dem Speichern immer »Test-Mail senden« klicken.
SMTP-Probleme (falsche Credentials, Firewall, TLS-Mismatch) zeigen sich erst beim
tatsaechlichen Versand.
Sub-Tab: Health & Monitoring
Echtzeit-Status aller Systemkomponenten. Das Dashboard aktualisiert sich automatisch
alle 30 Sekunden. Der DegradationManager schaltet bei Ausfaellen automatisch in
reduzierte Betriebsmodi.
Komponente antwortet, aber mit Einschraenkungen (hohe Latenz, wenig Speicher).
unhealthy
Rot
Komponente nicht erreichbar oder fehlerhaft.
Tipp: Der Health-Endpoint (/api/health) ist unauthentifiziert
und kann fuer externes Monitoring (Nagios, Prometheus, Uptime Kuma) verwendet werden.
Zusaetzlich gibt es Kubernetes-kompatible Probes: /api/health/ready
und /api/health/live.
Sub-Tab: Backup & Restore
Vollstaendige Sicherung und Wiederherstellung: Datenbank, Konfiguration, Templates
und optional die Vektordatenbank. Backups enthalten SHA256-Pruefsummen.
Backup erstellen
Feld
Typ
Standard
Beschreibung
VectorDB-Daten einschliessen
Checkbox
An
Wenn aktiviert, werden Qdrant-Snapshots ins Backup einbezogen.
Erhoeht die Backup-Groesse erheblich, spart aber bei Restore die
Neuindexierung.
Tipp — Backup-Strategie:
Taegliches Backup ohne VectorDB: Schnell und klein (~MBs). Bei Restore muss neu indexiert werden.
Woechentliches Backup mit VectorDB: Groesser (GBs bei vielen Chunks), aber vollstaendiges Restore ohne Neuindexierung.
Achtung: Die Wiederherstellung ueberschreibt die aktuelle Datenbank
und Konfiguration. Alle Aenderungen seit dem Backup-Zeitpunkt gehen verloren.
Vor einem Restore ein aktuelles Backup erstellen!
Sub-Tab: Performance (Cache)
Query-Cache-Statistiken. Der Cache beschleunigt wiederkehrende Anfragen und wird
bei Neuindexierung automatisch invalidiert. Aktualisiert sich alle 10 Sekunden.
KPI-Widgets
KPI
Beschreibung
Cache aktiv
Ja/Nein — ob der Query-Cache aktiviert ist.
Eintraege
Aktuelle Belegung vs. Maximum (z.B. 42 / 256).
Hit-Rate
Anteil der Anfragen, die aus dem Cache beantwortet wurden.
Hits / Misses
Absolute Zaehler: Cache-Treffer vs. Cache-Fehlschlaege.
TTL
Time-to-Live eines Cache-Eintrags in Sekunden.
Aktionen
Button
Beschreibung
Cache leeren
Invalidiert alle Cache-Eintraege sofort. Bestaetigung erforderlich.
Nuetzlich nach manuellen Datenbank-Aenderungen oder Config-Updates.
Tipp: Eine Hit-Rate unter 10% deutet darauf hin, dass die
meisten Anfragen einmalig sind — der Cache bringt wenig Nutzen. Eine Hit-Rate
ueber 30% zeigt, dass der Cache signifikant zur Antwortgeschwindigkeit beitraegt.
Sub-Tab: Integritaet
Prueft die Konsistenz aller 4 Datenschichten (Qdrant, Elasticsearch, chunk_datasources,
file_hashes). Die vollstaendige Dokumentation der Checks und Reparatur-Aktionen
findest du im VektorDB-Guide → Integritaetspruefung.
Pruefungen (Kurzuebersicht)
Button
Beschreibung
Laufzeit
Vollpruefung starten
5 Checks: Layer-Counts, DS-Coverage, ES-Duplikate, Orphan-Chunks, Overlapping DS.
Minuten (Background, Polling alle 2s).
Schnell-Check
Nur Layer-Counts vergleichen.
Sekunden (synchron).
Reparatur-Aktionen (bei Befund)
Aktion
Beschreibung
ds_ids synchronisieren
Schreibt ds_ids-Payload in Qdrant aus chunk_datasources neu.
Statistiken korrigieren
Aktualisiert chunk_count in datasource_embeddings.
Verwaiste Chunks loeschen
Loescht Chunks ohne chunk_datasources-Zuordnung (destruktiv).
Sub-Tab: Selbsttest
Fuehrt die gesamte Testsuite aus und prueft alle Systemkomponenten auf korrekte Funktion.
Laeuft im Hintergrund mit Live-Fortschrittsanzeige (Polling alle 1,5s).
Tipp: Uebersprungene Tests bedeuten, dass die jeweilige Komponente
nicht konfiguriert ist (z.B. LDAP-Tests ohne LDAP-Config, Cloud-Tests ohne API-Key).
Das ist kein Fehler — es zeigt nur, dass der Test nicht anwendbar ist.
Sub-Tab: Aenderungen (Changelog)
Chronologisches Protokoll aller Konfigurationsaenderungen. Zeigt wer wann was geaendert hat —
egal ob ueber die GUI oder den Admin-Chat.
Filter
Filter
Typ
Beschreibung
Bereich
Dropdown
Filtert nach Aenderungs-Bereich (z.B. users, datasources, ki, system). Dynamisch geladen.
Quelle
Dropdown
Alle, GUI, Chat.
Tabellen-Spalten
Spalte
Beschreibung
Sortierbar
Zeitstempel
Datum und Uhrzeit der Aenderung.
Ja
Benutzer
Wer die Aenderung vorgenommen hat.
Ja
Bereich
Betroffener Bereich (users, datasources, ki, ...).
Betroffenes Objekt (z.B. Datenquellen-Name, Template-Name).
Ja
Feld
Geaendertes Feld (z.B. name, is_active).
Ja
Detail-Ansicht (Expandable)
Klick auf eine Zeile zeigt die Vorher/Nachher-Werte im Vergleich:
alter Wert links, neuer Wert rechts. Bei JSON-Feldern werden die Werte formatiert
dargestellt.
Tipp: Der Changelog erfasst Aenderungen sowohl aus der GUI als auch
aus dem Admin-Chat. Das bedeutet: Wenn ein Admin per Chat »Deaktiviere Benutzer 5«
sagt, erscheint die Aenderung hier mit Quelle »Chat«. Nuetzlich fuer die
Nachvollziehbarkeit bei mehreren Admins.
Netzwerk-Diagnose (Admin-Chat)
Netzwerk-Diagnose-Tools sind ueber den Admin-Chat verfuegbar (kein eigener Sub-Tab).
Sie ermoeglichen die Fehlersuche bei Verbindungsproblemen direkt aus der Admin-UI.
Tipp: Die Netzwerk-Tools sind besonders nuetzlich bei der Ersteinrichtung
von Datenquellen-Konnektoren (SMB, WebDAV, IMAP) — sie ermoeglichen die Fehlersuche ohne
SSH-Zugang zum KIara-Server.
API-Endpunkte
Die vollstaendige API-Referenz wird dynamisch aus der Admin-Registry generiert: