/
3.8.2 Server-Logs aktivieren

3.8.2 Server-Logs aktivieren

Owned by CSE (OSB-Support)
Last updated: Aug 09, 2024

Die Server-Logs kann auf 2 Wegen aktivieren:

  • zur Laufzeit 
  • generell / dauerhaft


siehe auch: Wie kann man die Server-Logs/Protokolle aktivieren?
MEM-Log aktivieren bei Abschnitt "MEM-Log" unter: 2.6b enaio Protokolle:


Was ist wofür: 

Log-Typ

wofür 

Flow

Zeigt in Stufe 6 alle Funktionsaufrufe an. Am Server bitte nur auf Anforderung aktivieren und nur im angeforderten Level! 

Error

zeigt nur alle aufgetretenen Fehler an. Normalerweise wird immer ein Jobstack (also alles, was dazu gehört, wie Aufruf-Parameter, bei Events: zusammengebautes Event + Fehlerzeile) geschrieben 

Job / LOG

Protokolliert alle ausgeführten Job-Aufrufe mit Eingabe- und Ausgabe-Werten. Zusätzlich erhält man bei SQL-Abfragen ROW-Sets (Ergebnisse). Wichtig: nur Aufrufe, die zurückgekommen sind, werden protokolliert.  

SQL

Hier werden alle SQL-Statements aufgezeichnet, die an den ODBC-Treiber gesendet werden. Wichtig: Es werden nur korrekt abgesetzte Befehle protokolliert. 

MEM

Damit ist es möglich, die Systemauslastung sehr genau zu verfolgen, wie z. Bsp. Speicheranstieg. Ab Version 7.x gibt es einen periodischen Server-Job, der zusätzlich aktiviert werden muss.

ODBC

Es wird das ganze Verhalten des ODBC-Zugriffes protokolliert.

Schritt-für-Schritt-Anleitung

zur Laufzeit: 
Diese Einstellungen sind nur zur Laufzeit wirksam. Sobald der enaio Dienst neu gestartet wird, gilt wieder, was in der oxrpt.cfg steht. 

  1. enaio Enterprisemanager starten 
  2. bei Protokollierung auf das gewünschte Log gehen. Bitte beachten: Man muss im Baum (links) jeden Punkt einzeln anklicken, weil die config erst beim Klicken geladen wird. Am Ende steht man hier:
  3. Nun den gewünschten Kanal anklicken und per Doppelklick auf "angehalten" aktivieren bzw. deaktivieren. Der Level ist nur für Flow-Protokoll relevant. Alle anderen Kanäle müssen nur an oder aus sein. 
    Bitte beachten: Wenn man mehrfach hintereinander an oder ausschaltet, kann es vorkommen, dass sich der Dateiname ändert (das ist an sich egal, es ist nur wichtig, dass man am Ende die korrekte Log-Dateien ermittelt). 
  4. Dies kann auch für andere Server auf diesem Wege erfolgen. Man muss sich nicht extra auf dem Server1 oder Server2 einwählen, um das Logging zu aktivieren. 
    Übertragung, siehe auch: Wie kann man die Server-Logs der anderen Server übertragen? 
  5. Sobald der Log-Kanal wieder auf "angehalten=ja" steht, wird nicht mehr protokolliert. 


generell / dauerhaft:

  1. Den enaio Server-Pfad ermitteln (z. Bsp. über die Dienste-Eigenschaften).
  2. Darin liegt die Datei oxrpt.cfg. Diese enthält die Log-Einstellungen. Bitte beachten: Man kann Kanäle einrichten, damit nur bestimmte Komponenten protokolliert werden. Weiß man aber nicht, woher der Fehler kommt, sollte besser alles aktiviert werden. 
  3. Die Datei oxrpt.cfg kann man entweder mit einem beliebigen Text-Editor oder einem enaio CFG-Editor öffnen. Am Ende sollte die Datei wie im Beispiel aussehen.
    Beispiel: Flow ist auf Level 6 gestellt und das Err-Log ist auch an, Pfad ist c:\oslog

    [oxrpt\aliases\default]
    1=Error log
    2=Flow log
    3=Job call log
    4=SQL log

    [oxrpt\channels\Flow log]
    LogFileName=flw_%2_%4%6%7%5.evn
    Type=LOG
    ChannelID=15
    Level=6
    Suspended=0
    LogRecreate=1
    LogSizeControlOn=1
    LogMaxFileSize=8192
    LogExpirationDays=2
    LogHighWater=30
    LogLowWater=10

    [oxrpt\channels\Error log]
    LogFileName=err_%2_%4%6%7%5.evn
    Type=LOG
    ChannelID=8
    Level=3
    Suspended=0

    [oxrpt\channels\Job call log]
    LogFileName=log_%2_%4%6%7%5.evn
    Type=LOG
    Suspended=1

    [oxrpt\channels\SQL log]
    LogFileName=sql_%2_%4%6%7%5.evn
    Type=LOG
    Suspended=1

    [Params]
    LogPath=C:\OSLog

  4. enaio DIenst neu starten. Wichtig: Mit aktiviertem Log ist das ganze System sehr langsam. 
  5. Sobald die gewünschten Aktionen aufgezeichnet sind, über den enaio Enterprisemanager zur Laufzeit die Protokollierung abschalten und in jedem Fall in der oxrpt.cfg des Servers das Log wieder auf "suspended=1" stellen. Beispiel:
    [oxrpt\channels\Flow log]
    Level=6
    Suspended=1
  6. Ans Speichern denken! Ansonsten wird beim nächsten Dienststart wieder protokolliert. 


Das Flow-Log ist sehr ausführlich und zieht viel Performance. Manchmal ist es besser zur Fehleranalyse den enaio Servermonitor zu aktivieren. Dieser kann auch Jobs protokollieren, die gestartet, aber noch nicht zurückgekommen sind.  

Wie startet man eine Aufzeichnung im enaio Servermonitor?

Verwandte Artikel