Optionen: Nutzungsprotokoll und Aufbewahrung

Die Spalte On-Premise nennt den Wert, der in einer Installation im eigenen Haus gilt, solange nichts ausdrücklich gesetzt ist.

Option	Vorgabe	On-Premise	Wirkung
`UsageTrackingEnabled`	`true`	wie Vorgabe	eine JSONL-Zeile je Werkzeug-Aufruf: Werkzeug, Erfolg, Dauer, Sprache, Clientadresse, User-Agent, Pfad, Format
`UsageStoreContent`	`true`	`false`	zusätzlich die Inhalte: Upload, Ergebnis, Erstellen-Formular
`UsageDirectory`	`usage`	wie Vorgabe	Ablage relativ zum Installationsverzeichnis
`UsageRetentionDays`	`30`	wie Vorgabe	ältere Protokolle und Dateien werden beim Tageswechsel gelöscht
`UsageCorpusEnabled`	`true`	`false`	langlebige, anonymisierte Zweitkopie aller Artefakte für die Qualitätsanalyse der Engine
`UsageCorpusDirectory`	`usage/corpus`	wie Vorgabe	Ablage des Korpus
`UsageCorpusRetentionDays`	`0`	wie Vorgabe	`0` = nie automatisch löschen

Wo was liegt

Das Protokoll als usage/usage-JJJJMMTT.jsonl, die Inhalte unter usage/files/JJJJMMTT/.

Warum zwei Optionen on-premise aus sind

Dasselbe gilt für UsageStoreContent: Die Ereigniszeilen sind für den Betrieb nützlich, die Rechnungsinhalte sind es für den Betreiber selten — und ihre Ablage ist eine datenschutzrechtliche Entscheidung, die niemand ungefragt treffen sollte.

Zwei Dinge, die hier nicht stehen

Der Verlauf im Kontobereich ist etwas anderes: Er zeigt Verwaltungsereignisse eines Mandanten und liegt in der Datenbank, nicht im Dateisystem. Siehe Verlauf.

Das Anwendungsprotokoll (logs/) hat eine eigene Aufbewahrung von 30 Dateien und wird hier nicht gesteuert. Siehe Überwachung.

Werte am Code gegengeprüft am 22.10.2026.