Beobachtbarkeit: Logs, Debug-Leiste und Audit-Trail #

Diese Seite richtet sich an Ingenieure, die sehen müssen, was eine laufende Installation tut: um eine Seite zu debuggen, einen Vorfall zu untersuchen oder das System an eine Überwachung anzubinden. Exponential hat keinen eigenen Metrik-Endpunkt; es hat strukturierte Logs, einen Log-Viewer mit Suche, eine Debug-Leiste, einen manipulationssicheren Audit-Trail und Statusbefehle.

Inhalt #

1. Die Signale auf einen Blick
2. Logs
3. Der Log-Viewer und exp:logs
4. Die Debug-Leiste
5. Der Audit-Trail
6. Zustand und Status
7. Eine Untersuchung von Anfang bis Ende
8. Datenschutz in den Signalen

Die Signale auf einen Blick #

Logs #

• Die Debug-Logs und eZLog rotieren, wenn eine Datei site.ini [FileSettings] LogFileMaxSize (2 MB) übersteigt, und behalten LogFileRotateCount (3) Archive (Log-Rotation und Bereinigung).
• Nicht-gefunden-Antworten gehen mit dem Grund, den der Kernel fand, nach 404.log; was der Anfrageklassifizierer für eine Sondierung, einen Pfaddurchlauf, eine Injektion, ein Angriffswerkzeug oder eine Häufung von Nicht-gefunden-Antworten hält, geht nach security.log. Jede Anfrage wird nur in ein Log geschrieben, und die Klassifizierung blockiert nichts (Anfrage-Logs).
• Bei mehreren Websites können Logs in das Verzeichnis jeder Website oder auf ein anderes Dateisystem gehen (Logs, INI-Cache und Ablaufzeitstempel je Website).
• Code schreibt über eZDebug::writeError(), writeWarning(), writeNotice() und eZLog, nie mit echo oder var_dump (eZDebug und Protokollierung).

Der Log-Viewer und exp:logs #

Setup > Logdateien (setup/logs) listet jedes Log der Installation, verfolgt eines live, durchsucht eine Datei, jedes Kernel-Log oder jede Datei mit ihren Rotationen, zerlegt Zeilen in Zeit, Client, Siteaccess, Anfrage und Nachricht, gruppiert Zeilen nach Anfrage und verknüpft sie mit den Audit-Einträgen derselben Minute. Standardmäßig ist er nur lesend. Dasselbe in einer Shell:

./console exp:logs --help
./console exp:logs --reference=ERR-0123456789

Siehe Der Log-Viewer und Einen Fehler anhand seiner Referenz finden.

Die Debug-Leiste #

Die Exp-Debug-Leiste ersetzt den klassischen Debug-Bericht durch eine angeheftete Leiste: Seitenzeit, SQL-Anzahl und -Zeit, Spitzenspeicher, verwendete Templates, Warnungen und Fehler sowie Reiter für Meldungen, Einstellungen, Cache, Zeitmessung, SQL, Templates, eingebundene Dateien, Speicher und Velocity. Zeigen Sie sie nur Ihrer eigenen Adresse:

[DebugSettings]
DebugOutput=enabled
DebugByIP=enabled
DebugIPList[]=203.0.113.10

Hinter einem Proxy stimmt die Adresse nur, wenn der Proxy in TrustedProxies[] aufgeführt ist (Die Exp-Debug-Leiste, Anleitung zur Debug-Leiste).

Der Audit-Trail #

Sicherheitsrelevante Ereignisse (Anmeldungen und Ablehnungen, Inhaltsänderungen, Schreibvorgänge an Einstellungen, das Leeren von Caches, Bereitstellungen, Bestellungen, Änderungen der Mehrwertsteuer) werden in einem hashverketteten Log mit signierten Manifesten aufgezeichnet, standardmäßig eingeschaltet. Warnregeln achten auf Brute-Force-Anmeldungen, eine vergebene Administratorrolle, Einstellungen, die außerhalb der Arbeitszeit geschrieben werden, Massenlöschungen und eine gebrochene Kette.

./console exp:audit status --allow-root-user
./console exp:audit tail --channel=access --name='access.session.*' --lines=3 --allow-root-user
./console exp:audit verify --allow-root-user        # exit 1 when a chain is broken

Die Cronjob-Gruppe frequent muss für Indexierung, Warnungen und Rotation laufen (Der Audit-Trail, Anleitung zum Audit).

Zustand und Status #

Exponential hat keine einzelne URL für den Zustand. Kombinieren Sie eine Prüfung von außen (die Startseite und die Anmeldung der Administration, weil die Startseite aus einem Cache beantwortet werden kann, während die Datenbank ausgefallen ist) mit Statusbefehlen auf dem Server (Zustandsprüfungen und Verfügbarkeit, Überwachung im Überblick). Der Wartungsmodus antwortet mit 503 und Retry-After, sodass sich ein geplantes Fenster von einem Ausfall unterscheiden lässt.

Eine Untersuchung von Anfang bis Ende #

1. Ein Besucher meldet eine Fehlerseite mit einer Referenz: Suchen Sie sie im Log-Viewer oder mit exp:logs --reference.
2. Lesen Sie jede Zeile derselben Anfrage, dann die Audit-Einträge derselben Minute: Was hat sich kurz davor geändert?
3. Reproduzieren Sie mit eingeschalteter Debug-Leiste für Ihre Adresse.
4. Prüfen Sie security.log, wenn die Anfrage ungewöhnlich aussieht.
5. Halten Sie fest, was Sie gefunden haben (Umgang mit Störungen).

Datenschutz in den Signalen #

Log-Viewer, Anfrage-Logs und Audit-Trail maskieren standardmäßig E-Mail- und IP-Adressen, Tokens, Schlüssel, Session-IDs und Cookies; Passwörter und Geheimnisse werden nie aufgezeichnet. Das Aufheben der Maskierung im Log-Viewer braucht die Richtlinie setup/unmasklogs. Belassen Sie es so, wenn Sie Logs in ein anderes System exportieren.

Verwandte Seiten #

• Debugging und Logs
• Log-Viewer und Rotation, für Hoster
• Sicherheit und Audit
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.