Neben den Produktkonfigurationsoptionen, die im Abschnitt Einstellungen der Anwendungsoberfläche verfügbar sind, gibt es einige zusätzliche Konfigurationseinstellungen, die Benutzer anpassen können, um RayEval an ihre individuellen Anforderungen anzupassen.
Protokollierung der RayEval-Aktivität
Das Programmdatenverzeichnis (C:\Users\<username>\AppData\Roaming\RayEval\Logs) wird standardmäßig zum Speichern der Anwendungsaktivitätsprotokolldatei (dd-MM-yyyy-HH-mm-ss.log) verwendet. Wenn die Standardeinstellungen unverändert bleiben, fügt RayEval für jede DEBUG-Meldung des Systems, die während der Anwendungsnutzung generiert wird, eine neue Zeile in diese Protokolldatei ein.
Das Protokoll wird standardmäßig im Rolling-Appender-Modus verwendet, d. h. eine globale Protokolldatei wird dauerhaft erweitert, bis eine bestimmte Dateigröße erreicht ist. 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 Platz für die neueste Archivdatei zu schaffen.
Um die Standardeinstellungen für das Verhalten der Protokolldatei zu ändern, müssen Benutzer die Datei log4net.config manuell bearbeiten, die sich im Stammverzeichnis des Installationsordners von RayEval befindet (in der Regel etwa C:\Program Files (x86)\RayEval\). Die Einstellungen, die am wahrscheinlichsten für Anpassungen relevant sind:
Speicherort der Protokolldatei
Die Protokolldatei befindet sich standardmäßig unter ”C:\Users\<username>\AppData\Roaming\RayEval\Logs\dd-MM-yyyy-HH-mm-ss.log”. Es ist jedoch möglich, beliebige absolute lokale Pfade sowie freigegebene Netzwerkstandorte für die Protokollspeicherung zu definieren.
<file type="log4net.Util.PatternString" value="%env{AppData}\\RayEval\\Logs\\%date{yyyy-MM-dd HH-mm-ss}.log" /> |
|
Achtung: Der Benutzer, der RayEval ausführt, muss über Schreibberechtigungen für den Speicherort der Protokolldatei verfügen, um den Nachrichtenfluss zur Protokolldatei zu initiieren und aufrechtzuerhalten. Wenn der Benutzer nicht über ausreichende Zugriffsrechte verfügt, wird keine Fehlermeldung angezeigt und die Produktnutzung wird nicht eingeschränkt, aber die Systemaktivität wird nicht dokumentiert. Weitere Anweisungen bei fehlenden Protokollen finden Sie im Abschnitt Troubleshooting. |
Max. Protokolldateigröße
Die maximale Protokolldateigröße kann als "KB", "MB" oder "GB" definiert werden. Die Standardeinstellung für neu installierte RayEval-Instanzen ist "2048KB"
<maximumFileSize value="2048KB" /> |
Protokollierungsebene
Die am häufigsten verwendeten Protokollierungsebenen sind DEBUG, INFO, WARN, ERROR, FATAL, OFF. Dabei deaktiviert OFF die Protokollierung vollständig, FATAL ist die restriktivste Einstellung, die noch schreibt, und DEBUG 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 Anwendung und System produktiv in Betrieb sind, sollte die Protokollierungsebene WARNING für die laufende Wartung ausreichend sein.
<level value="DEBUG" /> |
Standardprotokollierungskonfiguration
Die Standardkonfigurationsdatei ist nachfolgend zur Überprüfung und als Sicherungsunterstützung aufgeführt:
<?xml version="1.0" encoding="utf-8" ?> <configuration>
<configSections> <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net"/> </configSections>
<log4net>
<appender name="RayEval" type="log4net.Appender.RollingFileAppender"> <immediateFlush value="true" /> <file type="log4net.Util.PatternString" value="%property{LogFilePath}\%date{dd-MM-yyyy-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="ALL" /> <appender-ref ref="RayEval" /> </root>
</log4net> </configuration> |
Weitere Informationen
RayEval verwendet eine externe Bibliothek für die Protokollierungsfunktionalitä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 sich direkt mit Datenbanken oder Ereignisprotokollierern verbindet. Es gibt zahlreiche Optionen für Layout- und Verhaltensanpassungen. RayEval-Systemadministratoren mit einem Hang zur Perfektion sind herzlich eingeladen, ihre eigene Logger-Konfiguration zu erstellen.