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.