Anfrage-Logs #

Diese Seite ist für Systemadministratoren und Support-Mitarbeitende eines Hosters. Sie beantwortet: wo eine Anfrage nach einer fehlenden Seite und eine Anfrage, die wie ein Angriff aussieht, festgehalten werden, was eine Zeile Ihnen sagt, wie personenbezogene Daten aus den Dateien herausgehalten werden, wie viel Festplatte sie belegen und wie Sie sie nutzen, wenn ein Kunde fragt, warum Besucher Fehler bekommen.

Jedes Format und jede Einstellung unten stammt aus Anfrage-Logs: 404.log und security.log, wo auch die Schnittstellen für Entwickler beschrieben sind. Die Sicherheitsseite hat eine eigene Seite: Sicherheitslog.

Inhalt #

1. Drei Logs statt einem
2. Eine Zeile in 404.log lesen
3. Datenschutz als Standard
4. Einstellungen
5. Festplattennutzung und Rotation
6. Die Logs im Support nutzen
7. Checkliste

Drei Logs statt einem #

Exponential schreibt eine Antwort „nicht gefunden“ und eine verdächtige Anfrage in eigene Logs, sodass error.log nur die echten Fehler enthält:

Jede Anfrage wird in eines davon geschrieben, nie in zwei: Eine Abtastung, die mit 404 endet, steht nur in security.log. Nichts wird blockiert; der Klassifizierer stuft nur ein (Anfrage-Logs, kurz gesagt).

Hinweis Auf einer Website, auf der der Webserver (oder ein Schutz davor) eine Anfrage ablehnt, bevor Exponential startet, steht diese Anfrage überhaupt nicht in diesen Logs. Suchen Sie sie in den eigenen Logs des Webservers.

Eine Zeile in 404.log lesen #

[ Oct 17 2026 09:00:04 ] [2001:db8:x:x] 404 GET /content/view/full/9999 siteaccess=site reason=node:9999 node=9999 referrer=https://example.org/news ua=5d41402a "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_5)"

Das Feld reason= macht das Log für den Support nützlich: node:9999 ist ein Link auf entfernte Inhalte, module:wp-admin ist ein Roboter, der nach einem anderen Produkt sucht, disabled:... ist eine Ansicht, die der Siteaccess abschaltet.

Datenschutz als Standard #

• Adressen werden maskiert ([RequestLogSettings] MaskIP=enabled): 203.0.x.x, 2001:db8:x:x. Die rohe Adresse wird nie in eine Datei geschrieben. disabled schreibt sie vollständig; die Seite der Funktion sagt, das nur für eine Website zu tun, die einen Grund und eine Rechtsgrundlage dafür hat.
• Werte der Query sind in 404.log ***; Geheimnisse und E-Mail-Adressen im Pfad werden maskiert.
• Der User Agent ist ein kurzer Hash plus seine ersten 60 Zeichen: genug, um ein Werkzeug vom anderen zu unterscheiden, kein Fingerabdruck.
• Der Log-Viewer maskiert erneut, was er zeigt, und die Fehlerübersicht ist immer maskiert.

Hinweis Die Maskierung verringert personenbezogene Daten in den Logs; sie entscheidet nicht, wie lange Sie sie aufbewahren dürfen. Das ist Teil Ihrer Datenschutzrichtlinie und der Ihres Kunden. Diese Seite ist keine Rechtsberatung; siehe Aufbewahrung von Logs und Daten, und holen Sie Ihren eigenen rechtlichen Rat ein.

Einstellungen #

site.ini [RequestLogSettings] (überschrieben in settings/override/site.ini.append.php):

Das Log-Verzeichnis ist var/log oder das eigene Log-Verzeichnis der Website mit [FileSettings] UseGlobalLogDir=disabled (Aufbau des Speichers). Der Klassifizierer wird in settings/requestclassifier.ini konfiguriert; siehe Sicherheitslog.

Festplattennutzung und Rotation #

Beide Logs sind Kernel-Logs des Log-Viewers, mit eigenen Rotationseinstellungen in settings/logviewer.ini [RotationSettings]: je 5 Archive, komprimiert, eine Größengrenze von 10 MB für den Cronjob-Teil logs und eine Bereinigung, die Archive von 404.log nach 30 Tagen und von security.log nach 90 Tagen entfernt. Während eine Zeile geschrieben wird, rotiert der Schreiber die Datei außerdem bei site.ini [FileSettings] LogFileMaxSize wie jedes andere Log (Log-Rotation).

# settings/override/logviewer.ini.append.php: keep security.log longer
[RotationSettings]
Keep[security]=10
MaxAgeDays[security]=365

Die Bereinigung läuft, wenn der Cronjob-Teil logs läuft (er ist in keinem Standard-Teil) oder wenn ./console exp:logs --apply --prune aufgerufen wird; siehe Log-Viewer und Log-Rotation.

Die Logs im Support nutzen #

Aus einer Shell lassen sich dieselben Dateien mit dem Befehl des Log-Viewers durchsuchen:

./console exp:logs --search='reason=node' --file=var/log/404.log --rotations

Checkliste #

• To do: NotFoundLog=enabled und MaskIP=enabled (die mitgelieferten Werte), es sei denn, der Kunde hat schriftlich anders entschieden.
• To do: Der Cronjob-Teil logs oder ein geplantes exp:logs --prune hält Archive innerhalb ihrer Altersgrenzen.
• To do: Support-Mitarbeitende kennen die Fehlerübersicht und ihre Gruppierung nach reason=.
• To do: Die Aufbewahrung der Anfrage-Logs ist Teil der Datenschutzdokumentation des Kunden.

Verwandte Seiten #

• Sicherheitslog
• Log-Viewer und Log-Rotation
• Überblick über die Überwachung
• request-shield und Request-Regeln
• Anfrage-Logs: 404.log und security.log (Referenz der Funktion)
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.