Das Kommando Brick Protokollieren erlaubt es, die Logausgaben der DLE in einer speziellen Bricklogdatei zu steuern. Im Prinzip handelt es sich um das DLE-Log, mit dem Unterschied, dass es lokal gespeichert wird.
Wird durch die Wahl einer Protokollstufe das Protokoll eingeschaltet, werden ab diesen Moment alle Protokollausgaben die über dieser Stufe liegen in die angegebene Protokolldatei ausgegeben.
Die Protokollierung kann durch die Wahl der Protokollstufe „Aus“ wieder beendet werden, die Datei wird dann auch geschlossen.
Das geschieht auch automatisch am Ende der DLE Ausführung (Folder-Aufruf).
Parameter:
- Protokollstufe: (optional) Gibt die Protokollstufe an. Standard ist "Brick".
- Brickkategorien: (optional) Bei der Protokollstufe „Brick (Benutzerdefiniert)“ können ein oder mehrere Kategorien gewählt werden, die protokolliert werden sollen.
- Benutzer: (optional) Es können optional ein oder mehrere (durch Semikolon getrennte) Benutzernamen angegeben werden. In dem Fall werden die Protokollausgaben nur für diese Benutzer erfolgen.
- Dateiname: (optional) Der Name der Protokolldatei. Relative Pfade gelten ab dem aktuellen Logverzeichnis. Absolute Pfade benötigen die normale DLE Zugriffsberechtigung (FileDirectories in der DLESessionConfig.xml).
Es kann mit den Platzhaltern {user} und {date} gearbeitet werden. Default ist der Dateiname brick_{user}_{date}.log. - An Datei anhängen: (optional) Bei der Auswahl „Nein“ wird die Datei mit dem nächsten Logeintrag überschrieben (gelöscht) und beginnt damit wieder neu.
- Format: (optional) Optional kann eine Formatangabe definiert werden. Default ist {date} {time} {date_time} {user} {level} {session} {brick} {line} {category} {certificated} {message}.
- Max. Dateigröße (Bytes): (optional) Default ist 20971520 (20 Megabytes). Wird die Dateigröße überschritten, wird die Protokolldatei geschlossen und die nächste geöffnet (gerollt).
- Max. Anzahl Dateien: (optional) Maximal diese Anzahl von Dateien werden gerollt. Default = 5.
- Anzahl Protokolltage: (optional) Anzahl der Tage, die eine Protokolldatei vorgehalten werden soll. Das Löschen der alten Protokolldateien funktioniert aber nur, wenn im Dateinamen der Platzhalter {date} verwendet wurde.
Die Protokollstufen haben folgende Bedeutung:
| Protokollstufe | Beschreibung |
|---|---|
| Aus | Keine Protokollausgabe, Datei wird nur geschlossen. |
| Fatale Fehler | Fehler, die die DLE Ausführung bedrohen. |
| Fehler | Normale Fehler. |
| Warnungen | Warnhinweise. |
| Brick Kommandos | Kommandos im Brick. |
| Brick (Benutzerdefiniert) | Nur bestimmte Kommandos im Brick, näher über die Brickkategorie bestimmt |
| Infos | Infoausgaben |
| Debugausgaben | Debugausgaben, sehr detailliert. |
| Traceausgaen | Noch feinere Debugausgaben |
| Alles | Alles Ausgeben, ein Synonym für Trace. |
Folgende Platzhalter sind im Format möglich:
| Platzhalter | Beschreibung |
|---|---|
| {date} | Das aktuelle Datum |
| {time} | Die aktuelle Uhrzeit, inklusive Millisekunden |
| {date_time} | Datum und Uhrzeit kombiniert |
| {level} | Protokollstufe |
| {user} | Benutzername |
| {session} | Session-ID |
| {category} | Logkategorie (Klassenname der DLE) |
| {brick} | Brick-Name und ID |
| {line} | Aktuelle Brickzeile |
| {certificated} | Brick ist Zertifiziert (Y) oder nicht (N) |
| {message} | Die Protokollnachricht |