Protokollierung

Zur Konfiguration der Protokollierung der enaio®-Anwendungen bearbeiten Sie die Datei oxrpt.cfg. Diese ist in den jeweiligen Installationsverzeichnissen von Server und Client-Komponenten zu finden.

Nach erfolgreicher Installation brauchen Sie hier keine Änderungen vorzunehmen. Die entsprechenden Konfigurationen in den Verzeichnissen der Client-, Capture-, Admin- und Server-Installationen entsprechen den bestmöglich angepassten Voreinstellungen für die jeweiligen Anwendungen.

Projektseitig Anpassungen an den Protokollierungskonfigurationen können über das Konfigurationstool axrptcfg.exe im jeweiligen Installationsverzeichnis vorgenommen werden.

Die installierten Protokolldateien enthalten verschiedene Protokollkanäle:

Kanal	Aktion-ID	Setup	Beschreibung
Error	8	Server, Client, Admin, Capture	Nur im Falle eines Programmfehlers werden Protokolleinträge erzeugt. Dieser Kanal ist als Voreinstellung für Admin und Server aktiv, für Client und Capture nicht aktiv.
Flow	15	Server, Client, Admin, Capture	Fortlaufende Protokollierung aller Programmaktivitäten. Dieser Kanal ist als Voreinstellung inaktiv und sollte nur bei Bedarf für entsprechende Analyse-Zeiträume bei der Fehlersuche aktiviert werden.
SQL	9	Server, Client, Admin, Capture	Protokollierung der SQL Anfragen, die von dem jeweiligen Modul abgesetzt werden. Dieser Kanal ist als Voreinstellung inaktiv und sollte nur bei Bedarf für entsprechende Analyse-Zeiträume bei der Fehlersuche aktiviert werden.
Job Call	7	Server	Protokollierung der Server-Jobaufrufe durch die Clients. Dieser Kanal ist als Voreinstellung inaktiv und sollte nur bei Bedarf für entsprechende Analyse-Zeiträume bei der Fehlersuche aktiviert werden.
HTTP	2	Server	Protokollierung von HTTP-Requests zwischen Server und Microservices. Dieser Kanal ist als Voreinstellung inaktiv und sollte nur bei Bedarf für entsprechende Analyse-Zeiträume bei der Fehlersuche aktiviert werden.
ODBC	14	Server	Protokollierung der Ergebnisdaten einer Datenbankabfrage des Servers an die Datenbank. Dieser Kanal ist als Voreinstellung inaktiv und sollte nur bei Bedarf für entsprechende Analyse-Zeiträume bei der Fehlersuche aktiviert werden.

Folgende Parameter dienen der Steuerung eines Protokollkanals und können im Projekt bei Bedarf konfiguriert werden:

Parameter	Scope	Wirkung
Level	pro Kanal	Protokolllevel, Werte zwischen 0, nur Fehler, und 6, maximal.
Suspended	pro Kanal	Protokollierung aktiv / nicht aktiv.
LogLongTerm	pro Kanal	Schnelle Protokollierung durch dauerhaft geöffnete Datei oder Protokollierung von mehreren Anwendungen in gemeinsame Datei. Dateien der schnellen Protokollierung können nicht gelöscht werden, da die aktuell schreibende Anwendung einen Handle darauf hält.
LogFileName	pro Kanal	Bezeichnung der Protokolldatei.
FilterName	pro Kanal	Filter für Protokolle.
LogRecreate	pro Kanal	Laufende Protokolldatei wird um Mitternacht beendet und mit dem neuen Tag wird eine neue Protokolldatei angefangen.
LogMaxFileSize	pro Kanal	Maximale Dateigröße der erzeugen Protokolldateien in Kilobyte. Nach Erreichen dieser Größe wird eine neue Protokolldatei geschrieben.
LogSizeControl	pro Kanal	Die Größe des Protokoll-Verzeichnisses wird durch enaio® gesteuert.
LogHighWater	pro Kanal	Maximal zulässige Größe aller Protokolldateien pro Kanal in MB.
LogLowWater	pro Kanal	Minimale Größe aller Protokolldateien pro Kanal in MB.
LogExpirationsDays	pro Kanal	Wert in Tagen. Dateien werden nicht bis zu LowWater gelöscht, sondern die neuesten nach Tagen bleiben bestehen.
LogPath	Kanalübergreifend	Pfad der Protokolldateien.

Voreinstellungen

Bei der Installation werden die Pfade für die Protokollierung auf {InstallDir}\log gesetzt werden. Je nach Installationspfad und Benutzerberechtigung kann es sinnvoll sein, diesen Pfad für die Client-Installationen zu ändern. Das Verzeichnis kann auf einem Netzlaufwerk liegen. Für Flow-Protokollierung und LogLongTerm-Protokollierung empfehlen wir das aus Performancegründen nicht.

Aktiv sind nur die Error logs in Admin- und Server-Installationen.

Anwendungen	Kanäle	Bezeichnung	LogLongTerm
Client / Capture	Error log	err_%2_%4%6%7%5.evn err_<app>_<user><ddmmyy>.evn	nicht aktiv
	Flow log	flw_%2_%4%6%7%5.evn flw_<app>_<user><ddmmyy>.evn	nicht aktiv
	SQL log	sql_%2_%4%6%7%5.evn sql_<app>_<user><ddmmyy>.evn	nicht aktiv
Admin	Error log ‑ aktiv	err_%2_%4%6%7%5.evn err_<app>_<user><ddmmyy>.evn	nicht aktiv
	Flow log	flw_%2_%4%6%7%5.evn flw_<app>_<user><ddmmyy>.evn	nicht aktiv
	SQL log	sql_%2_%4%6%7%5.evn sql_<app>_<user><ddmmyy>.evn	nicht aktiv
Server	Error log ‑ aktiv	err_%2_%6%7%5.evn err_<app>_<ddmmyy>.evn	aktiv
	Flow log	flw_%2_%6%7%5.evn flw_<app>_<ddmmyy>.evn	aktiv
	SQL log	sql_%2_%6%7%5.evn sql_<app>_<ddmmyy>.evn	aktiv
	Job call log	log_%2_%6%7%5.evn log_<app>_<ddmmyy>.evn	aktiv
	ODBC log	odbc_%2_%6%7%5.evn odbc_<app>_<ddmmyy>.evn	aktiv
	HTTP log	http_%2_%6%7%5.evn http_axsvckrn_110624.evn	aktiv

Für weitere Eigenschaften gelten die Standardwerte, beispielsweise maximale Dateigröße: LogMaxFileSize=12800 KB

Änderungen am Sicherheitssystem

Eine zusätzliche Protokollierung von Änderungen am Sicherheitssystem über die Bereiche 'Sicherheitssystem' und 'Dezentrale Benutzeradministration' kann über enaio® enterprise-manager eingeschaltet werden.

Protokollierung der Dienste und Microservices

Unabhängig von der Konfiguration der Protokollierung der enaio®-Anwendungen kann die Protokollierung der Dienste - enaio® gateway und enaio® documentviewer - und der Microservices konfiguriert werden.