Verwendung

Logdateien werden vom Administrator oder Support herangezogen, um die Ursache eines Problems zu analysieren. In CLARC ENTERPRISE werden standardmäßig von allen Services und einigen Tools Logfiles erzeugt. Der Log-Level kann dabei konfiguriert werden.

Im Falle eines aktiven Development-Schalters werden auch Logdateien von Subprozessen und Komponenten erzeugt.

Die maximale Größe von Logdateien beträgt 100 MByte. Überschreitet ein Log diese Größe, wird ein neues File mit entsprechendem Suffix angelegt.

Client-Anwendungen erzeugen im Standard keine Logdateien. Siehe Entwicklungs-Modus.

Verzeichnisse

Alle Logdateien werden immer unterhalb des folgenden Ordners erstellt:

<clarc>\log\

Debug-Logs standardmäßig in einem weiteren Unterordner \debug. Sowie Batch-Logs des CLARC AUTOMATION Processors im Unterordner \batch.

Log-Dateinamen

Die Namen der Logdateien sind immer wie folgt aufgebaut:

<Name des Prozesses>[-<Instanznummer>]-<Zeitstempel in der Form YYYYMMDD>[-<Logdatei-Nummer>].txt

Beispiel:

cwarpsrv-0-20160101.txt

Log-Stufen

Das System unterscheidet zwischen folgenden Log-Stufen (Loglevel):

Level	Stufe	Beschreibung
0	Silent	Es werden keinerlei Logausgaben gemacht.
1	Error	Es werden nur Fehler in den Logdateien ausgegeben.
2	Warning	Es werden nur Fehler und Warnungen in den Logdateien ausgegeben.
3	Info	Es werden Fehler, Warnungen und allgemeine Informationen in den Logdateien ausgegeben.
4	Debug	Es werden Fehler, Warnungen, Informationen und Debug-Ausgaben in den Logdateien ausgegeben (Standard).
5	Trace	Es werden alle verfügbaren Systemmeldungen in den Logdateien ausgegeben.

Aufbau

Alle Logfiles haben einen identischen Aufbau. Hier ein Beispiel:

11.06.16 00:13:43-313 localhost       info......: loading permission objects from /clarc/Permissions/Objects
11.06.16 00:13:43-328 localhost       info......: 13 permission objects and 0 sessions loaded (16ms)
11.06.16 00:13:43-328 localhost       info......: loading roles from /clarc/Permissions/Roles
11.06.16 00:13:43-344 localhost       info......: 2 roles loaded (16ms)
11.06.16 00:13:43-344 localhost       info......: loading users from /clarc/Permissions/Users
11.06.16 00:13:43-375 localhost       info......: 5 users loaded (31ms)

Der Aufbau einer Logzeile im Detail:

Bestandteil	Beschreibung	Länge	Beispiel
Datum	Log-Datum in der Form dd.mm.yy	8	10.06.16
Uhrzeit	Log-Uhrzeit in der Form hh:nn:ss-zzz - also inkl. Angabe der ms	12	00:53:08-249
Host	Name oder IP-Adresse des Quell-Systems (z.B. der Client-Rechner). Häufig auch "localhost.	15	localhost
Typ	Kurzbezeichner des Typs der Logausgabe (z.B. error, warning, info, etc.). Aufgefüllt mit "." und abgeschlossen mit einem ":".	10	info......:
Text	Eigentlicher Log-Text.	n	5 users loaded (16ms)

DevMode

Zu Analysezwecken kann ein erweitertes Logging aktiviert werden.

Siehe dazu Entwicklungs-Modus.