Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,059 of 9,059 pages
About the help in other languages
All help pages

exp:explogs

Der Log-Viewer auf der Kommandozeile: die Log-Dateien auflisten, einer folgen, sie und ihre Rotationen durchsuchen, eine Fehlerreferenz und die Zeilen ihrer Anfrage finden (standardmäßig maskiert); Logs rotieren und…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/examples/commands/explogs.md

On this page

This page is a translation. Read the English original

exp:explogs

Der Log-Viewer auf der Kommandozeile: die Log-Dateien auflisten, einer folgen, sie und ihre Rotationen durchsuchen, eine Fehlerreferenz und die Zeilen ihrer Anfrage finden (standardmäßig maskiert); Logs rotieren und ihre Archive aufräumen (Probelauf, außer mit --apply).

Skript bin/php/explogs.php, Code in kernel/private/classes/commands/explogs.php. Führen Sie es im Wurzelverzeichnis der Installation aus, als der Benutzer, unter dem der Webserver läuft:

./console exp:explogs --help
./console exp:logs --help
php bin/php/explogs.php --help

Hilfetext

Was --help ausgibt, so wie der Befehl es schreibt:

The log viewer on the command line (read only; e-mail and IP addresses and secrets masked unless --unmask)

./console exp:logs --list                                  the log files: group, size, time, lines a minute
./console exp:logs --tail=var/log/error.log --lines=50     the last 50 entries
./console exp:logs --tail=var/log/error.log --follow       follow it (Ctrl-C ends)
./console exp:logs --search=timeout --file=var/log/error.log --rotations --level=error,warning
./console exp:logs --search='/content/view/\d+' --regex --scope=kernel --from='2026-10-17 01:00' --to='2026-10-17 02:00'
./console exp:logs --reference=ERR-0123456789          where an error page's reference is, and its request
./console exp:logs --related=var/log/error.log:123456      the lines of the request of the entry at that offset

Log management (doc/eng-us/features/6.0/log-rotation.md):
./console exp:logs --archives                              each log with its archives and their sizes
./console exp:logs --rotate=error,debug --apply            rotate these logs now (keys as in --archives, or ids)
./console exp:logs --rotate-all --apply                    rotate every log that is not empty
./console exp:logs --prune                                 the archives beyond site.ini [FileSettings] limits
./console exp:logs --prune=error --apply                   remove them (all logs, or these)
./console exp:logs --compress --apply                      compress the archives from .2 on
./console exp:logs --truncate=debug [--in-place] --apply   empty a log (rotated, or in place)
--rotate, --rotate-all, --prune, --compress and --truncate change files only with --apply; without it
they print the plan. --dry-run means the same as no --apply; --apply together with --dry-run is a usage
error (exit 2).

Exit code: 0 something listed or found, 1 nothing found, 2 error.

Optionen

OptionWertHilfe
--listDie Logdateien, die der Viewer öffnen darf, nach Gruppe auflisten, mit Größe, Zeit und Zeilen pro Minute
--archivesDie rotierbaren Logs mit ihren Archiven (.1 .. .N, .gz), Größen und Grenzen auflisten
--rotateerforderlichDiese Logs jetzt rotieren, unabhängig von ihrer Größe: Schlüssel (error,debug,site-storage) oder IDs (var/log/error.log), durch Kommas getrennt
--rotate-allJedes Log über seiner MaxSize rotieren (mit --force: jedes Log, das nicht leer ist)
--forceMit --rotate-all: auch die Logs unter ihrer MaxSize
--pruneoptionalDie Archive über die Grenzen (Keep, MaxAgeDays) hinaus entfernen: von jedem Log oder von diesen Schlüsseln
--dayserforderlichMit --prune: Archive entfernen, die älter als so viele Tage sind, statt MaxAgeDays
--compressoptionalDie unkomprimierten Archive ab .2 komprimieren: von jedem Log oder von diesen Schlüsseln
--truncateerforderlichDiese Logs leeren: sie rotieren (der Inhalt bleibt in .1) oder mit --in-place die Datei selbst leeren
--in-placeMit --truncate: die Datei an Ort und Stelle leeren, ohne Kopie
--applyMit --rotate, --rotate-all, --prune, --compress oder --truncate: die Dateien ändern (Standard ist ein Probelauf, der den Plan ausgibt)
--dry-runDer Standard, beibehalten für Skripte, die die Option übergeben: nur den Plan ausgeben
--tailerforderlichDie letzten Einträge einer Datei (ihr Pfad relativ zum Wurzelverzeichnis, z. B. var/log/error.log)
--lineserforderlichMit --tail: wie viele Einträge (Standard 20)
--followMit --tail: weiter ausgeben, was zur Datei hinzukommt, mit zunehmendem Abfrageintervall (Strg-C beendet)
--intervalerforderlichMit --follow: das kürzeste Abfrageintervall in Millisekunden (Standard [TailSettings] PollInterval)
--searcherforderlichNach einem Text suchen (wörtlich oder als regulärer Ausdruck mit --regex)
--regexMit --search: der Text ist ein regulärer Ausdruck (begrenzt durch [SearchSettings] BacktrackLimit und TimeLimit)
--caseMit --search: Groß- und Kleinschreibung beachten
--fileerforderlichMit --search: die Datei (Standard: [LogViewerSettings] DefaultFile)
--scopeerforderlichMit --search: file (Standard), kernel (jedes Kernel-Log) oder all (jede aufgeführte Datei)
--rotationsMit --search: auch die Rotationen (.1 .. .N, .gz)
--levelerforderlichNur diese Stufen: error,warning,notice,debug
--fromerforderlichNur Einträge zu oder nach diesem Zeitpunkt (z. B. 2026-10-17 01:00)
--toerforderlichNur Einträge zu oder vor diesem Zeitpunkt (ein Datum allein bedeutet den ganzen Tag)
--saerforderlichNur Einträge dieses Siteaccess
--urierforderlichNur Einträge, deren Anfrage diesen Text enthält
--iperforderlichNur Einträge, deren Client-Adresse damit beginnt
--cursorerforderlichMit --search: dort weitermachen, wo eine frühere Suche aufgehört hat (ausgegeben als "More: --cursor=...")
--limiterforderlichMit --search: höchstens so viele Einträge ausgeben
--referenceerforderlichEine Fehlerreferenz (ERR-XXXXXXXXXX) in den Kernel-Logs und ihren Rotationen finden, mit ihrer Anfrage
--relatederforderlichDie Zeilen derselben Anfrage wie der Eintrag bei <file>:<offset>
--unmaskE-Mail-Adressen, IP-Adressen und Geheimnisse unmaskiert zeigen (die Werte geheimer Einstellungen bleiben verborgen)
--jsonEin JSON-Objekt statt des Textes
--colorerforderlichDie Stufen einfärben: auto (Standard: wenn die Ausgabe ein Terminal ist), always, never

Aus den Optionsdefinitionen im Code gelesen (startup(), getOptions(), options() oder ezcConsoleOption). Jedes Skript nimmt außerdem die Standardoptionen des Skript-Frameworks (--help, --siteaccess, --debug, --quiet, --allow-root-user ...).

Siehe auch


Erzeugt von ./console exp:help:examples --language=ger-de aus bin/php/explogs.php, kernel/private/classes/commands/explogs.php. Bearbeiten Sie diese Seite nicht: Ändern Sie die Quelle oder die deutsche Übersetzung und erzeugen Sie sie neu (wie). Freie Dokumentation: GFDL 1.3 oder später.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x