Neben den Produktkonfigurationsoptionen, die im Einstellungsbereich der Anwendungs-UI verfügbar sind, gibt es einige zusätzliche Konfigurationseinstellungen, die Benutzer anpassen können, um RayPack auf ihre individuellen Anforderungen zuzuschneiden.
Protokollierung der RayPack-Aktivität
Das Programmdatenverzeichnis (C:\Users\<username>\AppData\Roaming\RayPack\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 RayPack bei jeder DEBUG-Meldung, die während der Anwendungsnutzung erzeugt wird, eine neue Zeile zu dieser Protokolldatei hinzu.
Das Protokoll soll standardmäßig als Rolling Appender verwendet werden, was bedeutet, dass eine globale Protokolldatei dauerhaft erweitert wird, 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 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 RayPack befindet (normalerweise etwas wie C:\Program Files\RayPack\). Die Einstellungen, die am ehesten für Anpassungen von Interesse sind, sind:
Speicherort der Protokolldatei
Die Protokolldatei lautet standardmäßig „C:\Users\<username>\AppData\Roaming\RayPack\Logs\dd-MM-yyyy-HH-mm-ss.log.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}\\RayPack\\Logs\\%date{yyyy-MM-dd HH-mm-ss}.log" /> |
|
Achtung: Der Benutzer, der RayPack ausführt, muss Schreibberechtigungen im Protokolldateispeicherort haben, um den Nachrichtenfluss zur Protokolldatei zu initiieren und aufrechtzuerhalten. Wenn der Benutzer keine ausreichenden Zugriffsrechte hat, wird keine Fehlermeldung angezeigt und die tatsächliche Produktnutzung nicht eingeschränkt, aber es erfolgt lediglich ein Verlust der Systemaktivitätsdokumentation. 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 RayPack-Instanzen ist „2048KB"
<maximumFileSize value="2048KB" /> |
Protokollierungsebene
Die am häufigsten verwendeten Protokollierungsebenen sind DEBUG, INFO, WARN, ERROR, FATAL, OFF. Dabei verhindert OFF die Protokollierung vollständig, FATAL ist die restriktivste, aber noch schreibende Einstellung, und DEBUG die ausführlichste Option.
Die Empfehlung lautet, für neu eingerichtete Systeme die Ebene DEBUG zu verwenden, da viele der in diesem Modus protokollierten Informationen helfen können, Einstellungen bezüglich Zugriffsrechten und ähnlichem anzupassen. Sobald die Anwendung und das System produktiv in Betrieb sind, sollte die Einstellung der Protokollierungsebene auf WARNING für die dauerhafte Wartung ausreichend sein.
<level value="DEBUG" /> |
Standardmäßige Protokollierungskonfiguration
Die Standardkonfigurationsdatei wird nachfolgend als Referenz und Backup-Unterstützung angegeben:
<?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.ConsoleAppender"> <layout type="log4net.Layout.PatternLayout"> <IgnoresException value="False" /> <conversionPattern value="[%-5p] - %m%n" /> </layout> <threshold value="INFO" /> </appender> <appender name="RayPackFileAppender" 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" /> <encoding value="utf-8" /> </appender> <root> <level value="INFO" /> <appender-ref ref="ConsoleAppender" /> <appender-ref ref="RayPackFileAppender" /> </root> </log4net> </configuration> |
Weitere Informationen
RayPack verwendet eine externe Bibliothek zur Bereitstellung von Protokollierungsfunktionen. 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 Ereignisprotokollen verbunden ist. Es gibt zahlreiche Optionen für Layout- und Verhaltensmanipulationen. RayPack-Systemadministratoren mit einem Hang zur Perfektion sind herzlich eingeladen, ihre eigene individuelle Logger-Version zu konfigurieren.