Neben den Produktkonfigurationsoptionen, die im Einstellungsbereich der Anwendungsoberfläche verfügbar sind, gibt es einige zusätzliche Konfigurationseinstellungen, die Benutzer anpassen können, um RayQC an ihre individuellen Anforderungen anzupassen.
Protokollierung der RayQC-Aktivität
Das Programmdatenverzeichnis (C:\Users\<username>\AppData\Roaming\RayQC\Logs) wird standardmäßig zum Speichern der Anwendungsaktivitäts-Protokolldateien verwendet. Für jede gestartete RayQC-Instanz wird eine separate Protokolldatei erstellt. Wenn die Standardeinstellungen unverändert bleiben, fügt RayQC dieser Protokolldatei für jede INFO-Meldung auf Systemebene, die während der Anwendungsnutzung generiert wird, eine neue Zeile hinzu.
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 RayQC befindet (üblicherweise unter C:\Program Files (x86)\RayQCAdvanced\). Die Einstellungen, die am ehesten für Anpassungen von Interesse sind:
Speicherort der Protokolldatei
Die Protokolldateien werden standardmäßig unter C:\Users\<username>\AppData\Roaming\RayQC\Logs gespeichert. Es ist jedoch möglich, beliebige andere absolute lokale Pfade sowie freigegebene Netzwerkspeicherorte für die Protokollressourcenspeicherung zu definieren.
<file type="log4net.Util.PatternString" value="%env{AppData}\\Raynet\\RayQC\\Logs\\%date{yyyy-MM-dd HH-mm-ss}.log" /> |
|
Achtung: Der Benutzer, der RayQC ausführt, muss Schreibrechte am Speicherort der Protokolldatei besitzen, um den Nachrichtenfluss in die Protokolldatei initiieren und aufrechterhalten zu können. Wenn der Benutzer nicht über ausreichende Zugriffsrechte verfügt, erscheint keine Fehlermeldung und die eigentliche Produktnutzung wird nicht eingeschränkt, jedoch gehen die Systemaktivitätsdaten verloren. Im Fall fehlender Protokolle lesen Sie bitte den Abschnitt zur Fehlerbehebung für weitere Anweisungen. |
Max. Protokolldateigröße
Die maximale Protokolldateigröße kann als KB, MB oder GB angegeben werden. Die Standardeinstellung für neu installierte RayQC-Instanzen ist "2048KB"
<maximumFileSize value="2048KB" /> |
Protokollierungsstufe
Die am häufigsten verwendeten Protokollierungsstufen sind DEBUG, INFO, WARN, ERROR, FATAL, OFF. Dabei verhindert OFF jegliche Protokollierung, FATAL ist die restriktivste Einstellung, die noch schreibt, und DEBUG ist die ausführlichste Option.
Es wird empfohlen, für neu eingerichtete Systeme die Stufe DEBUG zu verwenden, da viele der in diesem Modus protokollierten Informationen bei der Anpassung von Einstellungen zu Zugriffsrechten und Ähnlichem hilfreich sein können. Sobald Anwendung und System produktiv laufen, sollte das Setzen der Protokollierungsstufe auf WARNING für die dauerhafte Wartung ausreichen.
<level value="DEBUG" /> |
Standard-Protokollierungskonfiguration
Die Standardkonfigurationsdatei wird nachfolgend zur Überprüfung und als Sicherungskopie bereitgestellt:
<?xml version="1.0" encoding="utf-8" ?> <configuration>
<configSections> <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net"/> </configSections>
<log4net>
<appender name="RayQC" type="log4net.Appender.RollingFileAppender"> <file type="log4net.Util.PatternString" value="%env{AppData}\\RayQC\\Logs\\%date{yyyy-MM-dd HH-mm-ss}.log" />
<rollingStyle value="Once" /> <maxSizeRollBackups value="2" /> <maximumFileSize value="10240KB" /> <staticLogFileName value="false" /> <immediateFlush value="true" /> <layout type="log4net.Layout.PatternLayout,log4net"> <param name="header" value="/***************************** LOG HEADER *****************************/
"/> <param name="footer" value="/***************************** LOG FOOTER *****************************/
"/> <conversionPattern value="%date [%thread] %-5level %logger - %message%newline" /> </layout> <threshold value="INFO" /> </appender>
<root> <level value="ALL" /> <appender-ref ref="RayQC" /> </root>
</log4net> </configuration> |
Weitere Informationen
RayQC verwendet eine externe Bibliothek, um die Protokollierungsfunktionalität bereitzustellen. 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 konfiguriert werden, dass es direkt mit Datenbanken oder Ereignisprotokollierern verbunden wird. Es gibt zahlreiche Optionen für Layout- und Verhaltensanpassungen. RayQC-Systemadministratoren mit einem Hang zur Perfektion sind herzlich eingeladen, ihre ganz eigene Logger-Version zu konfigurieren.