Logging

Das Vertec Logging protokolliert Informationen und Fehlermeldungen aller Vorgänge in und um Vertec (Vertec Apps, Vertec Addins, Vertec Service und Cloud Server). Jede Log-Information ist einem der folgenden Levels zugeordnet:

  • 10: Debug
  • 20: Info
  • 30: Warning
  • 40: Error
  • 50: Fatal

Alle Informationen ab Level 20 werden standardmässig protokolliert. Logeinträge mit dem Level 10 (Debug) werden nur geschrieben, wenn sie explizit eingeschaltet werden. Dafür gibt es sogeannte DebugCategories, welche in der Log-Section im Vertec.ini-File gesetzt werden.

Vertec legt dafür diverse Logfiles an, in welchen die verschiedenen Vorgänge aufgelistet werden. Es sind folgende Logfiles verfügbar:

Logfiles der Apps und Addins

Diese Logfiles werden pro Client unter Benutzer\AppData\Roaming\Vertec angelegt. Ein einfacher Weg, diesen Ordner direkt aufzurufen, ist über den Befehl %appdata%.

  • Geben Sie %appdata% direkt in die Adressleiste des Windows Explorers ein, oder
  • Klicken Sie auf Start > Ausführen (oder Windows+R) und geben Sie %appdata% ein

Damit öffnet sich direkt der Ordner Anwendungsdaten des angemeldeten Benutzers. Die Logfiles werden in einem Unterordner abgelegt, welcher den Namen des Ordners trägt, in welchem das entsprechende Programm liegt. Wenn also die Programme im Ordner C:\Programme\Vertec6 liegen, so werden die Logfiles in %appdata%\Vertec6 zu finden sein.

LogfileLoggingWird bei Programmstart überschrieben
Vertec.log Vorgänge in der Classic App Ja
Vertec.Desktop.log Vorgänge in der Desktop App Nein
Vertec.Cloud.log (Lokale) Vorgänge in der Cloud App Nein
VertecExceptions.log Exceptions mit Stacktrace (wie bei detaillierten Fehlermeldungen) Nein
WordAddin.log Vorgänge im Word Addin Ja
ExcelAddin.log Vorgänge im Excel Addin Ja
OutlookAddin.log Vorgänge im Outlook Addin Ja
VertecShell.log Vorgänge im Explorer Addin Ja

Eigenes Logfile definieren

Sie können in der Log-Section im Vertec.ini-File einen eigenen LogFileName angeben. Vorgänge der Classic App, Desktop App und der Cloud App werden dann in dieses File geloggt.

Dieses wird beim Programmstart nicht überschrieben, sondern alle Log-Informationen hinten angefügt.

Die maximale Grösse von Log-Dateien ist auf 1 MB beschränkt. Ältere Daten werden in Backup-Dateien 1-9 geführt (zum Beispiel: Vertec.Desktop.1.Log). Dieser Vorgang geschieht automatisch.

Logfiles der Services und Sessions

Diese Logfiles befinden sich im Ordner des Service Logins (bzw. des LocalSystem Accounts); je nach Betriebssystem unter C:\ProgramData\ oder unter C:\Documents and Settings\All Users\. Analog zum Ordner %appdata% (siehe oben) können Sie diesen Ordner direkt über %programdata% aufrufen.

LogfileLoggingWird bei Programmstart überschrieben
Vertec.log Vorgänge des Vertec Service Nein
Vertec.CloudServer.log Vorgänge des Vertec CloudServer Nein
Vertec.Sessions.log Vorgänge in den Sessions der Cloud Clients Nein

SQL Logging in die Datenbank

Alle oben genannten Logeinträge können zusätzlich systemweit in die Tabelle LOGDATA in der Datenbank geschrieben werden. Der Vorteil des SQL Loggings gegenüber den Logfiles ist, dass die Log-Outputs aller Clients zentral in der Datenbank gesammelt sind.

Im Abschnitt [Log] des Vertec.ini Files kann mit

SqlLogTable=True

das Logging in eine Tabelle namens LOGDATA aktiviert werden. Die Tabelle wird automatisch in der DB erstellt und enthält alle Log-Ausgaben, die auch in ein Logfile geschrieben würden.

Die Log-Tabelle LOGDATA enthält folgende Spalten:

LOGTIME

Datum und Zeit des Log-Eintrags

LOGCATEGORY

Log-Kategorie (interne Vertec Kennung der Log-Quelle)

LOGLEVEL

Log-Level. Debug, Info, Warning, Error oder Fatal.

LOGMESSAGE

der Text des Log-Eintrages

COMPUTER

der Rechner, von dem aus dieser Log-Eintrag gemacht wurde

LOGIN

der aktuelle Vertec User zum Zeitpunkt des Log-Eintrags

Die LOGDATA Tabelle wird bei einem Update gelöscht.

Loggen der Änderungen an persistenten Objekten

Mit der zusätzlichen Angabe von

ChangeLog=True

können sämtliche Änderungen an persistenten Objekten geloggt werden, also Erzeugen, Ändern und Löschen von Daten. Da dies im laufenden Betrieb sehr viele Daten generiert, empfehlen wir, dies gezielt einzuschalten und wieder auszuschalten, falls es nicht mehr benötigt wird.

Loggen mittels Script

Die python Methode log übergibt die Informationen direkt an das Vertec Logging System. Diese werden gleich verarbeitet wie oben, also in das entsprechende Logfile und/oder als Einträge in die Datenbank geschrieben.

log(category: string, level: int, msg: string)

Log Message in Vertec Logging System.

  • Levels:
    • 10: Debug Log
    • 20: Info Log
    • 30: Warning Log
    • 40: Error Log
    • 50: Fatal Log
  • category: max 50 Zeichen
  • msg: max 1000 Zeichen

Beispielscript

Registriert als Event-Script auf Löschen

# coding: windows-1252
#
#---Bezeichnung: EventLog:
#   Klassen: N
#   ObjectScript: N
#   ContainerScript: N
#   EventType: Kein
#   EventClass: To specify
#   EventMembers: To specify
#   ExtendedRights: N

import vtcapp

def main():
    #aktuell angemeldeter Benutzer
    vertecUserName = vtcapp.evalocl("Timsession.allInstances->first.login.asstring")
    #spezifiziere Kategorie
    logCategory = "ExampleCategory"
    #spezifiziere Level
    logLevel = 20
    #setze die Message zusammen
    logObjectType = argobject.eval("self->oclType.asstring")
    logObjectId = argobject.eval("boldid")
    vtcapp.log(logCategory,logLevel,"'%s' mit der ID '%i' gelöscht durch '%s'"  %(logObjectType,logObjectId,vertecUserName))
main()

Die Einträge im Script haben das Level 20, deshalb erscheinen sie automatisch im Logfile.

Werden die Einträge dem Level 10 zugeordnet, muss die Log-Section im Vertec.ini-File um die im Script spezifizierte Debug Kategorie vertec.ExampleCategory ergänzt werden, damit die Einträge gelistet werden.

Versionen vor Vertec 5.4

In frühen Vertec Versionen wurde das Logging über einen Registry-Key gesteuert:

HKEY_LOCAL_MACHINE/Software/Vertec/Vertec

Dort gibt es zwei Werte:

  • LogFileName: Ist dort ein Pfad gesetzt, wird in dieses File geloggt.
  • DebugCategories: In der Grundeinstellung werden Info und Error Meldungen geloggt und so keine zu grossen Mengen an Logeinträgen generiert. Für spezielle Debugging-Zwecke kann hier eine Liste von Debug Categories angegeben werden (mit Komma getrennt), für welche zusätzliche Debuginformationen ins Logfile geschrieben werden.Mögliche Werte sind z.B vertec.dbmtim und vertec.sync.
LogFileName = c:\vertec.log
DebugCategories = vertec.dbmtim, vertec.sync

Wenn Sie Vertec schon lange einsetzen, sind diese Werte bei Ihnen vielleicht noch aktiv. Sie können aber jederzeit auf die Standard Logfiles umstellen, indem Sie die entsprechenden Werte in den Abschnitt [Log] des Vertec.ini Files eintragen und die Registry-Einträge löschen.


22.04.2013 | 03.08.2016: Informationen Vertec 6.0 eingefügt, Artikel umstrukturiert.
Produktlinien: Diverse
Module: Leistung & CRM