CIB webdesk technischer Leitfaden
7. Betrieb
7.4. Beschreibung wichtiger Log-Einträge
Verschiedene Fehlersituationen finden sich in der Log-Datei als Java-Exceptions wieder.
Ein Eintrag entspricht dabei dem folgenden Muster:
ERROR … :Exception occured (oder andere Meldung)
ERROR … : vollqualifizierter Name der Exception …
ERROR … : mehrzeiliger Stacktrace mit Methodennamen und Zeilennummern
ERROR … : Caused by: Gekapselte Exception
ERROR … : mehrzeiliger Stacktrace mit Methodennamen und Zeilennummern
Es folgt eine Beschreibung besonderer Exceptions nach denen die Logdatei durchsucht werden können um Probleme in der technischen Infrastruktur oder beim Zusammenspiel der einzelnen Komponenten automatisiert zu erkennen. Die Meldungen bei den gekapselten Exceptions geben typischerweise genaueren Hinweis auf die konkrete Ursache.
|
Exception |
Erläuterung |
|
de.cib.webdesk.exceptions.AuthenticationException |
Anmeldung am System fehlgeschlagen. Dies kann mehrere Gründe haben. Beispielsweise Nutzer ist nicht vorhanden oder Passwort nicht korrekt. |
|
de.cib.webdesk.exceptions.StorageConnectionException |
Hinweis auf Datenbank-Fehler. Sowohl
aufgrund von Nicht-Erreichbarkeit, Netzwerkproblemen usw. als auch
Konfigurationsfehler, fehlende Tabellen oder ähnliches. |
|
de.cib.webdesk.exceptions.WebdeskIOException |
Hinweis auf Probleme mit dem Dateisystem.
Prüfen sie ob alle erforderlichen Verzeichnisse existieren, Berechtigungen
korrekt gesetzt sind und genügend Speicher auf dem Datenträger frei ist. |
|
de.cib.webdesk.exceptions.DocumentServerCallException |
Hinweis auf Probleme im CIB documentServer oder bei der Kommunikation mit diesem. |
|
java.lang.OutOfMemoryError |
Die JVM hat nicht mehr genügend Hauptspeicher. Prüfen sie die Aufrufargumente und stellen Sie wenn möglich einen Heapdump bereit, so dass geprüft werden kann ob ein Speicherleck in der Software vorliegt. |
|
de.cib.webdesk.exceptions.WebdeskSystemException |
Sollte ebenfalls überwacht werden, da ein Auftreten auf Konfigurationsprobleme oder Fehler in der Software hinweisen kann. |
|
de.cib.webdesk.exceptions.WrongExternalAccountException |
Es wurde versucht sich mit einem Mandanten anzumelden der in der Persistenz nicht angelegt ist. Kann bei gehäuftem Auftreten ein Hinweis auf Fehlkonfiguration oder ein organisatorisches Problem / falsche Integration von CIB darktom sein. |
|
de.cib.webdesk.exceptions.DataModelCorruptionException |
Deutet auf einen schwerwiegenden Fehler im internen Datenmodell hin. |
Nachfolgende eine Liste von Exceptions, die im Regelbetrieb in der Logdatei auftreten können – typischerweise aber kein technisches Problem indizieren:
|
Exception |
Erläuterung |
|
de.cib.webdesk.exceptions.DocumentGenerationException |
Fachlicher Fehler in Vorlagen oder Datenversorgung |
|
de.cib.webdesk.exceptions.CheckMaskViolationException |
Ein generiertes Dokument entspricht nicht der Prüfschablonen |
|
de.cib.webdesk.exceptions.FontListViolationException |
Ein generiertes Dokument entspricht nicht der Schriftenliste |
|
de.cib.webdesk.exceptions.VersionException |
Für eine Vorlage oder Paket konnte keine gültige Version ausgewählt werden |
Andere Exceptions in den Logs deuten auf Fehler in der Fachlichkeit hin und müssen bei Auftreten durch CIB geprüft werden.