Vergleichsreport

Mit diesem Formular kann die Funktionsweise der Protokollierung (Logging) punktgenau festgelegt werden. Es ist möglich festzulegen, bei welchen Usern und bei welchen Bildschirm-Aktionen gelogged werden soll Des weiteren ist es möglich auch festzulegen, welche Programmteile protokollieren sollen.

Wohin die Protokolle geschrieben werden sollen ist über die so genannten Appender einstellbar. Im Webdesk EWP stehen standardmäßig 4 Appender zur Verfügung:

Appender

Beschreibung

Database

Dieser Appender stellt das komfortabelste Log-Medium dar, hier wird jedes Event in einen Log pro Aktion und User geschrieben. Dieses Log gilt für die gesamte Verweildauer innerhalb einer Aktion (das bedeutet, dass auch das Blättern innerhalb eines Aktion dazuzählt!) Der Nachteil ist, dass diese Protokollierungsart auch die aufwendigste darstellt, da ständig schreibende Datenbankzugriffe erfolgen.

Console

Dieser Appender schreibt auf die Konsole des Servlet Containers (z.B. Tomcat) in welchem der Webdesk EWP Server abläuft. Es handelt sich hierbei um ein Text-File, das chronologisch aufgebaut ist. Es ist hier naturgemäß schwierig, Log-Events von einzelnen Usern herauszufiltern.

Error-File

This form lets you define the way logging works with precision. You can specify for which users and for which screen actions logging should take place. You can also specify which program parts should log.

Where the logs are written can be set via so-called appenders. Webdesk EWP provides 4 appenders by default:

• Alle Aktionen loggen Durch anklicken der Check-Box werden alle Aktionen (Menüpunkte) geloggt   (protokolliert)Aktionen, welche geloggt werden sollenAuswahl einer bestimmten Aktion, die protokolliert werden soll Alle User loggen Log all actions
  Clicking the checkbox logs (records) all actions (menu items)
• Actions to be logged
  Select a specific action to be logged
• Log all users (Log All Users?) Durch anklicken der Check-Box werden alle User geloggt (protokolliert) Folgende User loggen Auswahl der User aus der Übersicht 
  Clicking the checkbox logs (records) all users
• Log the following users
  Select the users from the "Available Users" overview
• Available Users -   zeigt die verfügbaren User an - shows the available users
• Your Selection -   zeigt die ausgewählten User an
Einschränkung auf eine bestimmte Anzahl von Usern (anklicken eines Benutzers aus der Auswahlliste, dann anklicken des einfachen Pfeils -  so werden die markierten Benutzer übernommen. Klickt man auf den Doppelpfeil, so werden alle Benutzer übernommen
• - shows the selected users
• Restriction to a specific number of users (click a user in the selection list, then click the single arrow - the selected users are then added. If you click the double arrow, all users are added)
• Loglevel of Jobs
  Debug, Info, Warn, Error, Fatal, All  Festlegung der Priorität  von Fehlermeldungen (wobei Debug die unterste Ebene darstellt und die meisten Meldungen ausgibt - Bsp. "lade Datensatz mit Nummer
  Definition of the priority of error messages (where Debug is the lowest level and outputs the most messages - e.g., "loading record with number...". Info - es werden nur Meldungen ausgegeben, die eine höhere Priorität haben als Infoonly messages with a higher priority than Info are output. Error / Fatal - es werden nur Fehlermeldungen ausgegebenonly error messages are output)
• Loglevel of Connectors Analog dem Loglevel der Jobs Category Hier kann der Logger auf Java- Modulebene festgelegt werden (z.B
  Analogous to the log level of the jobs
• Category
  Here the logger can be defined at Java module level (e.g.: at.workflow.webdesk > loggt das angegebene Modullogs the specified module)
• Additivity
• true / false Definiert, ob die Log-Events auch an alle übergeordneten Log-Appender weitergegeben werden sollen. Beispiel: Es gibt einen Root-Logger, der auf die Konsole loggt, wenn nun ein untergeordneter Logger auf die DB logged, und dieses Flag auf true steht, werden alle Events auch an den Console-Appender weitergeleitet
  Defines whether the log events should also be passed on to all parent log appenders. Example: There is a root logger that logs to the console; if a subordinate logger now logs to the DB and this flag is set to true, all events are also forwarded to the console appender!
• Loglevel
  Debug, Info, Warn, Error, Fatal, All  Festlegung der Priorität von Fehlermeldungen
Debug - stellt die unterste Ebene der Protokollierung dar, gibt die meisten Meldungen aus. Bsp. "lade Datensatz mit Nummer
• 
  Definition of the priority of error messages
• Debug - represents the lowest level of logging and outputs the most messages. E.g., "loading record with number...".
• Info - es werden nur Meldungen ausgegeben, die eine höhere Priorität haben als Infoonly messages with a higher priority than Info are output.
• Error / Fatal - es werden nur Fehlermeldungen ausgegeben
• All - Ausgabe aller Meldungen
Appender Der Appender definiert, wohin eine Kategorie geloggt (protokolliert) wird (siehe add category) > gibt an, wohin die Ausgaben umgeleitet werden:
• Datenbank - Ausgaben werden in die Datenbank umgeleitet (und können mit der Ansicht Logeinträge später eingesehen werden!)
• Console - die Ausgaben werden auf die Console ausgegeben (das ganze zu finden im only error messages are output
• All - Output of all messages
• Appender
  The appender defines where a category is logged (recorded) (see add category) > specifies where the output is redirected to:
• Database - Output is redirected to the database (and can be viewed later in the Log entries view!)
• Console - the output is written to the console (found in tomcat5/logs/stdout.log)
• Log File - die Ausgabe wird auf ein spezielles log- File ausgegebenthe output is written to a special log file
• Error File - in dieser Datei sollten nur die wirklichen Fehlermeldungen protokolliert werden only the actual error messages should be logged in this file (File: webdesk3/WEB-INF/logs/error.log)
• add AppenderHinzufügen eines neuen Appenders delete Appender Die Definition wird gelöscht add Category Anhängen eines Logs an ein Package (Name muss mit Package übereinstimmen) delete Category Die Kategorie wird gelöscht

Die Datenbankprotokollierung (Appender = DATABASE) ist ausschließlich aktiviert, wenn der angemeldete User und die aufgerufene Aktion zur Protokollierung aktiviert wurden. Hier ist die korrekte Parametrierung des oberen Teils des Formulars von wesentlicher Bedeutung!

Wichtige Logger:

Name des Loggers

Beschreibung

shark

Logger für die Workflow Engine

• 
  Add a new appender
• delete Appender
  The definition is deleted
• add Category
  Attach a log to a package (name must match the package)
• delete Category
  The category is deleted

Database logging (Appender = DATABASE) is only enabled if the logged-in user and the called action have been enabled for logging. The correct configuration of the upper part of the form is essential here!

Important loggers:

Conversely, it is not necessary to enable actions or users for logging if logging is done to media other than the database. (Example: CONSOLE, FILE, ERROR-FILE)

Bei Fragen zur detaillierten Funktionsweise der Parameter kontaktieren Sie bitte die If you have questions about the detailed functioning of the parameters, please contact Workflow EDV GmbH.