Protokolldateien

Grundsätzlich speichert regisafe alle im laufenden Betrieb auftretenden Ereignisse (wichtige Aktionen und Fehler) in einer Protokolldatei LOGFILE.XML im TEMP-Verzeichnis.

Die Protokolldatei LOGFILE.XML wird in einheitlicher Form sowohl am IQ-Server als auch am regisafe-Client geführt.
Bei jedem Neustart, bei Beginn eines neuen Tages und ab einer bestimmten Dateigröße (siehe Schlüssel "ProtokolldateiGröße") wird eine neue Protokolldatei begonnen, die alte Datei wird umbenannt in LOGFILE-alt-<Zeitstempel>.XML.

Zu jedem Protokolleintrag werden bestimmte Details festgehalten, dazu gehören:

• Zeitpunkt
• Typ (z.B. Ereignis, Start einer Aktion, Ende einer Aktion)
• Level (z.B. Fehler, Log)
• Fehlernummer (Q-Nummer)
• Thread-ID
• IQ-Modul
• Meldungstext
• Zusatzinformationen
• Dauer (nur bei Aktionen)

Durch die Speicherung von Detailinformationen zu den einzelnen Protokolleinträgen ist es bei der Auswertung möglich, gezielt nach bestimmten Einträgen zu suchen: also z.B. Einträge vom Typ Fehler, Einträge zu bestimmten Modulen oder Einträge in bestimmten Zeiträumen.

• Falls eine Debug-Protokollierung für einzelne Module im IQ-Monitor aktiviert wird, werden entsprechende Einträge ebenfalls in die Protokolldatei geschrieben.

Protokolldatei-Viewer

Protokolldateien werden in regisafe in einem eigenen Protokolldatei-Viewer angezeigt (z.B. am Client beim Klick auf Protokoll in einer Fehlermeldung oder am IQ-Server beim Öffnen über das Menü).

Der Protokolldatei-Viewer bietet folgende Möglichkeiten:

• Der Inhalt der Protokolldatei wird in einer Liste angezeigt, ähnlich den regisafe-Trefferlisten
• Enthält die Protokolldatei mehr als 10.000 Protokolleinträge, wird eine zeitliche Auswahl angeboten, um die anzuzeigenden Protokolleinträge einzugrenzen.
• Über entsprechende Eingabe- bzw. Auswahlfelder kann die Liste gefiltert werden (z.B. nach Modul oder Meldungs-Typ)
• Per Doppelklick auf einen Eintrag werden die Details zu diesem Eintrag in einem separaten Fenster angezeigt
• Der Befehl Verzeichnis öffnen öffnet das Verzeichnis der Protokolldatei im Windows-Explorer
• Der Befehl Als Mail senden öffnet eine neue Mail mit der Protokolldatei als Anlage. Standardmäßig wird support@regisafe.de als Empfänger vorgegeben.
• Der Befehl In Zwischenablage kopieren kopiert alle Angaben zu einem Protokolleintrag in die Zwischenablage zur beliebigen Weiterverarbeitung
• regisafe-Protokolldateien können per Drag & Drop aus dem Windows-Explorer in den Viewer gezogen und geöffnet werden
• Als Schriftstück abgelegte regisafe-Protokolldateien werden beim Öffnen automatisch im Viewer angezeigt. Dasselbe gilt für Protokolldateien in einer Mail-Anlage.

 

Viewer-Fenster:

 

StartLog.txt

In der Datei StartLog.txt wird der Start des regisafe-Clients bzw. des IQ-Servers protokolliert: Alle geladenen Module inkl. Dateiversion und Quellverzeichnis, ausgeführte Initialisierungsfunktionen, usw. werden zusammen mit Zeitangaben aufgeführt.
Um schnell und direkt auf diese Informationen zugreifen zu können, wird der Inhalt der StartLog.txt nach Beendigung des Startvorgangs in der Protokolldatei LOGFILE.XML als Abschluss der Startphase aufgenommen.
Die Datei StartLog.txt wird bei jedem Start von regisafe bzw. oder dem IQ-Server neu erstellt. Beim Programmstart wird eine frühere StartLog.txt-Protokolldatei umbenannt nach StartLog-alt.txt, bevor mit dem Schreiben der neuen Protokolldatei begonnen wird.

• Auch wenn Sie in der INI-Datei ein eigenes Temp-Verzeichnis definiert haben, wird die Datei StartLog.txt dennoch in das Standard-Temp-Verzeichnis (siehe unter Temp-Verzeichnis) geschrieben.

Weitere Protokolldateien

Einige Anwendungsmodule oder Basisfunktionen erstellen eigene Protokolldateien, z.B. TerminManagerSyncLog.txt bei der Synchronisation eines Pocket-PCs mit dem regisafe-Terminkalender, TelefonwahlLog.txt bei der Nutzung der Telefonwahl, Report-Dateien der Reorganisation (siehe unter Protokollierung der Reorganisation).

• Diese Protokolldateien werden als TXT-Dateien im Temp-Verzeichnis bzw. einem Unterverzeichnis angelegt.