Neben den Produktkonfigurationsoptionen, die im Bereich Einstellungen der Anwendungsoberfläche verfügbar sind, gibt es einige zusätzliche Konfigurationseinstellungen, die Benutzer anpassen können, um PackBench auf ihre individuellen Anforderungen auszurichten.
Protokollierung der PackBench-Aktivität
Das Programmdatenverzeichnis (C:\Users\<username>\AppData\Roaming\RayBench\Logs) wird standardmäßig zum Speichern der Anwendungsaktivitätsprotokolldatei ({yyyy-MM-dd HH-mm-ss}.log) verwendet. Wenn die Standardeinstellungen unverändert bleiben, fügt PackBench dieser Protokolldatei für jede DEBUG-Systemmeldung, die während der Anwendungsnutzung generiert wird, eine neue Zeile hinzu.
Standardmäßig wird das Protokoll als Rolling Appender verwendet, d. h. eine globale Protokolldatei wird dauerhaft erweitert, bis eine bestimmte Dateigröße erreicht wird. Sobald diese erreicht ist, werden die ältesten Zeilen automatisch in ein Archiv von Protokolldateien übertragen, das standardmäßig auf 10 Dateien begrenzt ist. Wenn dieses zweite Limit erreicht ist, wird das älteste Archiv entfernt, um einen Platz für die neueste Archivdatei freizugeben.
Um die Standardeinstellungen für das Protokolldateiverhalten zu ändern, müssen Benutzer die Datei log4net.config manuell bearbeiten, die sich im Stammverzeichnis des Installationsordners von PackBench befindet (normalerweise etwa C:\Program Files (x86)\RayPack\PackBench). Die Einstellungen, die am ehesten für Anpassungen von Interesse sind, sind:
Speicherort der Protokolldatei
Der Standardspeicherort der Protokolldatei ist „C:\Users\<username>\AppData\Roaming\RayBench\Logs\{yyyy-MM-dd HH-mm-ss}.log”. Es ist jedoch möglich, beliebige andere absolute lokale Pfade sowie freigegebene Netzwerkspeicherorte für die Protokollressourcenspeicherung festzulegen.
<file type="log4net.Util.PatternString" value="%env{AppData}\\PackBench\\Logs\\%date{yyyy-MM-dd HH-mm-ss}.log" /> |
|
Achtung: Der Benutzer, der PackBench ausführt, muss über Schreibberechtigungen für den Protokolldateistandort verfügen, um den Nachrichtenfluss zur Protokolldatei initiieren und aufrechterhalten zu können. Wenn der Benutzer nicht über ausreichende Zugriffsrechte verfügt, wird keine Fehlermeldung angezeigt und die Produktnutzung wird nicht eingeschränkt, aber die Systemaktivitätsdokumentation geht verloren. Weitere Anweisungen bei fehlenden Protokollen finden Sie im Abschnitt Fehlerbehebung. |
Max. Protokolldateigröße
Die maximale Protokolldateigröße kann als „KB", „MB" oder „GB" definiert werden. Die Standardeinstellung für neu installierte PackBench-Instanzen ist „2048KB"
<maximumFileSize value="2048KB" /> |
Protokollebene
Die am häufigsten verwendeten Protokollebeneinstellungen sind DEBUG, INFO, WARN, ERROR, FATAL und OFF. Dabei verhindert OFF die Protokollierung vollständig, FATAL ist die restriktivste Einstellung, die noch schreibt, und DEBUG ist die ausführlichste Option.
Für neu eingerichtete Systeme wird empfohlen, die Ebene DEBUG zu verwenden, da viele der in diesem Modus protokollierten Informationen dabei helfen können, Einstellungen bezüglich Zugriffsrechten und Ähnlichem anzupassen. Sobald die Anwendung und das System produktiv laufen, sollte die Einstellung der Protokollebene auf WARNING für die dauerhafte Wartung ausreichend sein.
<level value="DEBUG" /> |
Standardprotokollierungskonfiguration
Die Standardkonfigurationsdatei wird unten als Referenz und Sicherungsunterstützung bereitgestellt:
<?xml version="1.0" encoding="utf-8"?> <configuration>
<configSections> <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net" /> </configSections>
<log4net> <appender name="ConsoleAppender" type="log4net.Appender.ColoredConsoleAppender"> <layout type="log4net.Layout.PatternLayout"> <conversionPattern value="[%-5p] - %m%n" /> </layout> <threshold value="Info" /> <mapping> <level value="DEBUG" /> <foreColor value="Yellow" /> </mapping> <mapping> <level value="INFO" /> <foreColor value="White" /> </mapping> <mapping> <level value="ERROR" /> <backColor value="Red, HighIntensity" /> <foreColor value="White" /> </mapping> <mapping> <level value="WARN" /> <foreColor value="Red" /> </mapping> </appender>
<!--<appender name="EventLogAppender" type="log4net.Appender.EventLogAppender" > <applicationName value="PackBench Service" /> <layout type="log4net.Layout.PatternLayout"> <conversionPattern value="%d [%t] %-5p %c - %m%n" /> <param name="ConversionPattern" value="%d [%t] %-5p %c - %m%n" /> </layout> </appender>-->
<appender name="RayBenchFileAppender" type="log4net.Appender.RollingFileAppender"> <immediateFlush value="true" /> <file type="log4net.Util.PatternString" value="%property{LogFilePath}\%date{yyyy-MM-dd-HH-mm-ss}.log" /> <param name="StaticLogFileName" value="false" /> <maximumFileSize value="10240KB" /> <rollingStyle value="Once" /> <maxSizeRollBackups value="2" /> <layout type="log4net.Layout.PatternLayout,log4net"> <param name="header" value="/***************************** LOG HEADER *****************************/
" /> <param name="footer" value="/***************************** LOG FOOTER *****************************/
" /> <param name="ConversionPattern" value="%d [%t] %-5p %c - %m%n" /> </layout> <threshold value="INFO" /> </appender>
<root> <level value="INFO" /> <appender-ref ref="ConsoleAppender" /> <appender-ref ref="RayBenchFileAppender" /> <!--<appender-ref ref="EventLogAppender" />--> </root> </log4net> </configuration> |
Weitere Informationen
PackBench verwendet eine externe Bibliothek zur Bereitstellung der Protokollierfunktionalität. Weitere Details zu verfügbaren Konfigurations- und Nutzungsoptionen finden Sie in der Online-Dokumentation des log4net-Projekts (http://logging.apache.org/log4net/). log4net kann so angepasst werden, dass es direkt mit Datenbanken oder Ereignisprotokollen verbunden wird. Es gibt zahlreiche Optionen zur Layout- und Verhaltensanpassung. PackBench-Systemadministratoren mit einem Hang zur Perfektion sind herzlich eingeladen, ihre ganz eigene Logger-Version zu konfigurieren.