CxDataloggerViewer OnlineHelp

Diese Beschreibung setzt ein grundlegendes Verständnis für die Funktionsweise des CxDataLoggers und dem dazugehörigen Viewer voraus.

Der CxDataLoggerViewer ist eine CxFrame unabhängige MFC Applikation. Der Viewer verbindet sich via TCP Socket mit dem CxDataLogger. Es können sich mehrere Viewer gleichzeitig an den selben Server anmelden. Es können gleichzeitig mehrere Instanzen des Viewers auf dem gleichen Rechner in Betrieb sein. Viewer und Server können auf beliebigen Rechnern laufen.

Per Default wird der IP Port 6211 (6210 für den Windows Service) benutzt. Dieser kann in der Registry (Server) und auf dem UI (Viewer) geändert werden. Der Viewer verbindet sich selbständig mit dem Server wenn dieser gestartet wird und trennt die Verbindung natürlich auch wenn der Server beendet wird.

Die Verbindung mit dem Viewer kann via CxSec geschützt werden. Ist die Applikation CxSec geschützt (Globales Flag im CxF File) so muss ein Benutzername und das Passwort angegeben werden. Diese User muss für die CxSec Funktion "Modul Data Logger" mindestens Readonly Rechte besitzen. Der Benutzer im Viewer ist unabhängig von dem benutzer, welcher aktuell in der Applikation (Server) angemeldet ist.

Der CxDataLoggerViewer registriert (wenn die Berechtigungen ausreichend sind!) die drei Datei Erweiterungen in der Registry.
Somit können die drei Dateiearten direkt  mit einem Doppelklick geladen/angezeigt werden:

.CxLogConfig (bisher CxLog); Enthält die gespeichert Einstellungen. (Verbindungsdaten, Filterdaten, Farbmarkierungem)
.CxLogData (bisher *.log); Enthält die eigentlichen Logdaten
.CxLogArchiv; Enthält die geshrinkten Logdaten. (Zip-File mit Logdateien, eine je Shrinkprozess)

Hinweis: Die Registrierung der Extensions sollte auch durch das Applikationssetup bei der Installation der Anwendung durchgeführt werden.

Funktionsübersicht

Menü Datei

Die Viewer Einstellungen können mit der Funktion Speichern oder Speichern unter... in eine *.CxLogConfig Dateien gesichert und natürlich auch wieder mit Öffnen... geladen werden. (auch via Toolbar)

Mit Öffnen... kann jedoch auch direkt eine Log oder Archiv Datei geöffnet werden. (funktioniert auch durch Doppelklick auf eine der drei Dateiarten)

Der ganze Inhalt der Liste kann mit Exportire/Alle Daten in eine... als CSV, XML oder Excel Datei gespeichert werden. (Es werden dazu die Funktionen aus dem CxListCtrl benutzt)

Menü Bearbeiten

Einzelne markierte Zeilen können mit der Funktion Kopieren ins Clipboard kopiert werden.

Es kann mit der Funktion Suchen (auch via Toolbar) und Nächsten suchen (F3) über alle im Viewer angezeigten Logzeilen gesucht werden. (nicht im eigentlichen Logfile!)

Mit der Funktion Farbmarkierungen (auch via Toolbar) könne Zeilen als ganzes farblich markiert werden wenn ein bestimmter Text darin enthalten ist.

Menü Ansicht

Der Viewer kann mit der Funktion Immer im Vordergrund (auch via Toolbar) angepinnt werden, so dass der Viewer immer im Vordergrund angezeigt wird.

Menü Funktionen

Mit der Funktion  Einstellungen Online Verbindung... (auch via Toolbar) kann die Verbindung zum gewünschten Server konfiguriert werden.

Mit der Funktion Logdatei direkt laden... (auch via Toolbar) kann anstelle der Online-TCP Verbindung zum CxDatalogger Server direkt eine Logdatei oder ein Logarchiv (Zip-Datei) geöffnet und analog wie bei IP-Verbindungen gefiltert und eingesehen werden.
Der einzige Unterschied im Filter ist das Startdatum: Kein Startdatum bedeutet im Online-TCP Modus ab: jetzt, im direkten Datei Modus bedeutet dies jedoch: ab Dateianfang.
Soll vom direkten Dateimodus wieder in den Online-TCP Modus gewechselt werden so muss dies im Verbindungseinstellungs Dialog wieder aktiviert werden.

Mit der Funktion Logdatei überprüfen... kann eine Logdatei auf Manipulation hin überprüft werden. Dazu fügt der Datalogger automatisch alle 200 Zeile eine Hashzeile in die Logdatei ein. (Alte Logdateien vor Version 2.9.0 werden natürlich als fehlerhaft ausgewiesen, da die Hashzeile noch fehlt.)

Mit der Funktion Filter bearbeiten... (auch via Toolbar) können Filter (Zeitfenster,Typen, Include und Exclude Textestrings) definiert werden. Diese Filter werden zum Server übertragen, so dass der Viewer nur noch die gewünschten Daten erhält.
Wird der Viewer gestartet so wird das Filter Startdatum auf die aktuelle Zeit gesetzt, so dass per Default nur die neuen Logs angezeigt werden.

Mit der Funktion  Übertragung unterbrechen (auch via Toolbar Pause) kann die Übertragung der Logs angehalten werden. (Auch im direkt Datei Modus!)

Mit der Funktion aktive Logdatei im Server kopieren... (auch via Toolbar) kann die aktive Logdatei (ganz oder teilweise) auf dem Server kopiert werden. Es kann ein optionaler Dateiname angegeben werden. Wird kein Name angegeben so wird auf dem Server ein Datei mit Zeitstempel im Namen erzeugt. Die Datei wird immer ins
aktuelle Verzeichnis des CxDataLoggers erstellt. Es kann ein optionaler Log Startzeitpunkt angegeben werden. Wird keine Datum/Zeit angegeben, so wird die gesamte Logdatei kopiert.

Mit der Funktion aktive Logdatei vom Server laden... kann die aktuelle Logdatei via TCP vom Server zum Viewer heruntergeladen werden. Die aktuelle Logdatei wird dazu in ein temporäres LogArchiv gezippt und dieses Archiv wird übertragen. Die heruntergeladene Datei kann dann direkt im Viewer geöffnet werden.

Mit der Funktion Logarchiv vom Server laden... kann das LogArchiv vom Server zum Viewer heruntergeladen werden.
Das Downloaden der Datei hat immer tiefere Priorität als die Übertragung der aktuellen Logs. Die Dateiübertragung kann also beschleunigt werden, wenn die Übertragung der Logs mit Pause (Verbindung/Übertragung unterbrechen) unterbrochen wird.
Die heruntergeladen Datei kann dann direkt im Viewer geöffnet werden.
Im Hintergrund werden dazu alle Logdateien in ein Temp-Verzeichnis extrahiert, gemäss Dateinamen sortiert und zu einer Logdatei zusammengefügt, diese temporäre Logdatei wird geöffnet. Beim ordnungsgemässen Schliessen wird das komplette Temp-Verzeichis wieder gelöscht.

Die Setuppage WebExtension für den CxWatchDog kann via CxWatchDog Daten anzeigen... (auch via Toolbar) direkt aus dem CxDataLoggerViewer aufgerufen werden.

Die CxWebSQL Funktionalität kann via CxWebSQL... (auch via Toolbar) direkt aus dem CxDataLoggerViewer heraus aufgerufen werden. Dazu muss natürliche die CxWebSQL Komponenete auf dem Server geladen sein.

Weitere Funktionen

Es können im 1 Minuten Schritten weiter ältere Meldungen angezeigt werden. Diese Funktion ist nur via Toolbar erreichbar.

Die aktuelle Ansicht kann gelöscht werden (Dazu wird das Filterstartdatum auf die aktuelle Zeit gesetzt!) Diese Funktion ist nur via Toolbar erreichbar.

Im Zeitdifferenz Fenster wird die Zeitdifferenz zwischen der selektiert Zeile und der Zeile unter dem Mauszeiger angezeigt.

Ist die letzte Zeile im Viewer selektiert so ist der Autoscrollmodus aktiviert.