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 RayQC Advanced an ihre individuellen Anforderungen anzupassen.
Protokollierung der RayQC Advanced-Aktivität
Das Programmdatenverzeichnis (C:\Users\<username>\AppData\Roaming\RayQCAd\Logs) wird standardmäßig zum Speichern der Anwendungsaktivitäts-Protokolldatei (dd-MM-yyyy-HH-mm-ss.log) verwendet. Wenn die Standardeinstellungen unverändert bleiben, fügt RayQC Advanced für jede DEBUG-Meldung auf Systemebene, die während der Anwendungsnutzung generiert wird, eine neue Zeile zu dieser Protokolldatei hinzu.
Das Protokoll wird standardmäßig 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 wird, wird das älteste Archiv entfernt, um einen Platz für die neueste Archivdatei freizumachen.
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 (normalerweise so etwas wie C:\Program Files (x86)\RayQCAdvanced\). Die Einstellungen, die am ehesten für Anpassungen relevant sind, sind:
Speicherort der Protokolldatei
Der Standardspeicherort der Protokolldatei ist C:\Users\<username>\AppData\Roaming\RayQCAd\Logs\dd-MM-yyyy-HH-mm-ss.log. 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}\\RayQC AdvancedAd\\Logs\\%date{yyyy-MM-dd HH-mm-ss}" /> |
|
Achtung: Der Benutzer, der RayQC Advanced ausführt, muss Schreibberechtigungen für den Protokolldateispeicherort haben, um den Nachrichtenfluss zur Protokolldatei zu initiieren und aufrechtzuerhalten. Wenn der Benutzer keine ausreichenden Zugriffsrechte hat, gibt es keine Fehlermeldung oder tatsächliche Einschränkung der Produktnutzung, sondern lediglich einen Verlust der Systemaktivitätsdokumentation. Weitere Anweisungen bei fehlenden Protokollen finden Sie im Abschnitt zur Fehlerbehebung. |
Max. Protokolldateigröße
Die maximale Protokolldateigröße kann als KB, MB oder GB definiert werden. Die Standardeinstellung für neu installierte RayQC Advanced-Instanzen ist "2048KB"
<maximumFileSize value="2048KB" /> |
Protokollebene
Die am häufigsten verwendeten Protokollebenen sind DEBUG, INFO, WARN, ERROR, FATAL, OFF, wobei OFF die Protokollierung vollständig verhindert, FATAL die restriktivste Einstellung mit noch aktivem Schreiben ist und DEBUG die ausführlichste Option ist.
Es wird empfohlen, die Ebene DEBUG für neu eingerichtete Systeme zu verwenden, da viele der in diesem Modus protokollierten Informationen dabei helfen können, Einstellungen zu Zugriffsrechten und Ähnlichem anzupassen. Sobald Anwendung und System produktiv laufen, sollte das Festlegen der Protokollebene auf WARNING für den laufenden Betrieb ausreichend sein.
<level value="DEBUG" /> |
Standardprotokollierungskonfiguration
Die Standardkonfigurationsdatei wird nachfolgend als Referenz und zur Sicherung bereitgestellt:
<?xml version="1.0" encoding="utf-8" ?> <configuration>
<configSections> <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net"/> </configSections>
<log4net>
<appender name="RayQCAdvanced" 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="10MB" /> <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="RayQCAdvanced" /> </root>
</log4net> </configuration> |
Weitere Informationen
RayQC Advanced verwendet eine externe Bibliothek für die Protokollierungsfunktionalität. Weitere Informationen 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 Event-Loggern verbunden wird. Es gibt zahlreiche Optionen zur Layout- und Verhaltensanpassung. RayQC Advanced-Systemadministratoren mit einem Hang zur Perfektion sind herzlich eingeladen, ihre eigene Logger-Version zu konfigurieren.