Docs

LOGGING

Dokumentation
Zurück

LOGGING

Wofür ist das?

Das LOGGING-Plugin sammelt Audit-Logs für den Mandanten:

  • Wer hat sich angemeldet?
  • Wer hat einen Vertrag bearbeitet?
  • Welcher AUTOMATE-Task ist gelaufen und mit welchem Ergebnis?
  • Welche kritischen Aktionen (Löschen, Berechtigungsänderung, Backup) sind passiert?

Damit haben Sie eine Nachvollziehbarkeit und können bei Problemen oder Streitfragen zurückblicken.


Typische Aufgaben (Alltag)

  • Nach Vorfällen schnell ins Log schauen
  • Filter setzen (Zeitraum, Benutzer, Plugin, Aktion)
  • Exportieren / archivieren

Schritt-für-Schritt

1) Logs ansehen

1. Admin → Logging (/settings/admin/logging).
2. Liste durchsuchen / filtern.
3. Eintrag öffnen → Details (User, Zeit, Aktion, betroffener Datensatz).

2) Logs aufbewahren / aufräumen

  • Alte Logs landen abhängig von der Konfiguration:
  • in der Mandanten-Datenbank (Tabelle für Audit-Logs)
  • und/oder im Log-Verzeichnis des Mandanten (<tenant-root>/logs)
  • Aufräumen kann über einen AUTOMATE-Task laufen (z.B. „Logs älter als X Tage löschen“).

3) Tagesgeschäft: schnellen Überblick

  • Sehen Sie sich am Anfang/Ende des Tages 1× das Log an, um ungewöhnliche Aktionen zu erkennen.
  • Bei Tickets/Eskalationen: zuerst Log prüfen, dann fragen.

Häufige Fragen / Probleme

„Logs sind leer“

  • Plugin LOGGING wirklich aktiv?
  • Schreibrechte im Log-Verzeichnis vorhanden?

„Logs werden zu groß“

  • Aufräumen via AUTOMATE einrichten.
  • Speicherort prüfen (<tenant-root>/logs).

„Ich finde eine bestimmte Aktion nicht“

  • Filter zurücksetzen.
  • Manche Aktionen werden nur grob protokolliert (z.B. „Mieter geändert“ statt jedes einzelnen Felds) – Schwerpunkt liegt auf wichtigen Vorgängen.

Technische URLs / Pfade (Kurzreferenz)

Admin:

  • GET /settings/admin/logging – Logs-Übersicht

Verzeichnis:

  • <tenant-root>/logs – Datei-Logs (sofern aktiv)
  • DB-Tabelle: audit_log (intern)

Hinweise

  • LOGGING ist primär ein Lese-/Audit-Werkzeug. Es verändert keine Geschäftsdaten.
  • Beachten Sie Datenschutz: Logs können personenbezogene Daten enthalten – Aufbewahrungsfristen entsprechend setzen.