Protokolle – Wartung
Von der Wartungsansicht aus können Sie auf den Protokollbaum zugreifen, Protokollverbindungen anzeigen und Protokolle herunterladen.
Das Service Management Tool von Efecte erstellt eine große Auswahl an Protokollen für unterschiedliche Zwecke. Das Ziel der Protokolldateien, die maximale Größe und die Protokollrotation können entsprechend den Kundenanforderungen definiert werden.
Die folgenden Protokolle werden standardmäßig erstellt:
- Sicherheitsprotokoll : Zeichnet alle sicherheitsrelevanten Aktivitäten auf, z. B. An- und Abmeldevorgänge von Benutzern, Genehmigungen von Workflow-Problemen usw.
- Konfigurationsprotokoll : Protokolliert Änderungen an der Lösungskonfiguration auf der Administrationsoberfläche
- Integrationsprotokoll : Protokolliert Ereignisse im Zusammenhang mit der Web API zum Importieren und Exportieren von Daten
- Anwendungsfehlerprotokoll : Zeichnet Fehler und Warnungen im Zusammenhang mit dem Anwendungsserver auf
- Datenkarten-Zugriffsprotokoll (optionale, separat lizenzierbare Funktion): Zeichnet alle Ansichten von Problemen sowohl in der Listen- als auch in der Detailansicht für die Vorlagen auf, für die es entsprechend konfiguriert ist.
- Effie AI-Protokoll : Protokolliert, welche Effie AI-Funktionen verwendet werden. Dazu gehören E-Mail-Funktionen und Aktionsauslöser. Die Standardprotokollebene ist INFO. Folgende Informationen sind verfügbar:
- Funktionsinformationen (Generieren, Korrigieren, Abschließen, Aktion).
- Eindeutige Kennung für den Benutzer, um eindeutige/wiederkehrende Benutzer zu verfolgen.
- Zeitstempel.
- Name der Vorlage.
- Anzahl der Token in der Anfrage.
Protokolle herunterladen
Um über die ESM-GUI mit „Protokolle herunterladen“ auf Protokolldateien zugreifen zu können, muss zunächst die Plattformeinstellung „log.files“ definiert werden, die ESM mitteilt, welche Protokolldateien heruntergeladen werden sollen. Die Plattformeinstellungen können über Wartung > Einstellungen bearbeiten bearbeitet werden. Geben Sie die Speicherorte der gewünschten Protokolldateien oder Ordner als Werte der Einstellung an. Wenn der Wert ein Ordner ist, werden alle darin enthaltenen Dateien heruntergeladen.
Baumstamm
Mit dem Protokollbaum können Sie Protokolle in Echtzeit überwachen. Die Protokolle werden in einem hierarchischen Baum angezeigt. Durch Klicken auf das Protokoll am Stamm des Baums werden alle Protokolle mit ihrem aktuellen Protokollierungslevel angezeigt. Sie können auch nach einer bestimmten Komponente suchen und deren Protokollierungslevel erhöhen. Dies ist in der Regel erforderlich, wenn Sie nach der Ursache eines Problems suchen.
Protokollverbindungen
Mit „Verbindungen protokollieren“ können Sie eine Liste offener Verbindungen im Protokollbaum anzeigen.
Änderung der Pro in der Benutzeroberfläche
Sie können Protokolleigenschaften in der Ansicht ändern, die geöffnet wird, wenn Sie im Protokollbaum auf ein Protokoll klicken.
In der Ansicht wird der Name des ausgewählten Protokolls angezeigt. Mit den Auf- und Abwärtspfeilen im Feld Level können Sie die Protokollierungsebene für die in der Protokolldatei unter \Efecte\log gespeicherten Protokolle ändern. Die Ebene wird hinter den Pfeilen angezeigt.
Wenn Sie eine Nachricht senden möchten, um zu überprüfen, ob die Protokollierung auf der ausgewählten Ebene funktioniert, klicken Sie auf die Schaltfläche Testnachricht senden.
Um die in der Ansicht angezeigte Echtzeit-Protokollierungsebene zu ändern, wählen Sie im Dropdown-Menü die entsprechende Ebene aus. Die verfügbaren Ebenen (von der am wenigsten ausführlichen bis zur ausführlichsten) sind:
- Tödlich
- Fehler
- Warnen
- Info
- Debuggen
- Verfolgen
Um die Protokolle nur aus der Ansicht zu löschen, klicken Sie auf die Schaltfläche Löschen . Die Protokolldatei selbst wird nicht gelöscht.
Um die Aktualisierung der Echtzeitprotokolle in der Ansicht zu beenden, klicken Sie auf die Schaltfläche „Trennen“ .
Um die Ansicht zu schließen, klicken Sie auf die Schaltfläche „Schließen“ .
Änderung der Pro
Administratoren können ihre eigene Protokollierungsrichtlinie in der Datei custom-log.properties definieren, die sich in der lokalen Bereitstellung unter installationDIR/Webapp/WEB-INF/ befindet. Die dort definierte fortlaufende Richtlinie überschreibt die Standardrichtlinie. Wenn ESM beispielsweise lokal im Verzeichnis /opt/efecte_le installiert ist und die Webanwendungs-ID efecte lautet, sollte die Richtlinie in der Datei /opt/efecte_le/efecte/WEB-INF/custom-log.properties abgelegt sein.
Alternativ in Cloud-Bereitstellungen: /var/lib/efecteone/tenant_files/xxx/itsm/files/itsm/WEB-INF/custom-log.properties
Um die Änderungen in custom-log.properties zu aktualisieren, ist ein Neustart von Tomcat erforderlich.
Wenn der Kunde keine eigene Datei „custom-log.properties“ wie oben beschrieben definiert, verwendet ESM die eigene Standardressourcendatei „custom-log.properties“. In der Datei „custom-log.properties“ können zwei verschiedene Rolling-Policys je nach Zeitintervall oder Speichergrößenbeschränkung definiert werden: TimeBaseRollingPolicy und SizedBasedTriggeredTriggeringPolicy.
Änderung der Protokolleinstellungen in den Plattformeinstellungen
Protokolleinstellungen haben einen eigenen Abschnitt in den Plattformeinstellungen. ESM wird standardmäßig im ConsoleAppender-Modus installiert. Andere Protokollierungsmechanismen können durch entsprechende Änderungen (z. B. des Protokolldateispeicherorts) an den Einstellungswerten angewendet werden. Ausführliche Anweisungen zur Konfiguration der log4j-Einstellungen finden Sie in der log4j-Onlinedokumentation unter http://logging.apache.org/log4j/1.2/manual.html.
Beispiel für ein Sitzungsprotokoll
Wenn Sie beispielsweise die Sitzungen von ESM-Benutzern überwachen möchten, können Sie SessionLogger verwenden und es mit den folgenden Anweisungen konfigurieren:
- Gehen Sie zu Wartung > Systemeinstellungen > Plattformeinstellungen bearbeiten.
- Suchen und aktivieren Sie diese 5 Einstellungen (mit Standardwerten), indem Sie das Kontrollkästchen vor der Einstellung aktivieren:
- log4j.logger.com.bitmount.boas.log.SessionLogger
- log4j.appender.session
- log4j.appender.session.layout
- log4j.appender.session.layout.ConversionPattern (dieser Standardwert sollte auch in den Plattformeinstellungen geändert werden, um nicht eine große Datei, sondern eine jährliche oder vierteljährliche Datei zu erstellen).
- log4j.appender.session.File
- Starten Sie den ESM/Efecte Tomcat-Dienst neu.
- Überprüfen Sie, ob session.log unter Wartung > Protokolle > Protokolle herunterladen heruntergeladen werden kann.
- Laden Sie die Datei session.log herunter und öffnen Sie sie im Editor, um die Benutzernamen, Anmelde- und Abmeldezeiten, die Gesamtsitzungszeiten und den Speicherort der Benutzerkarten im Berechtigungsbaum von ESM anzuzeigen:
- LOGIN aB6UArhznRMgTtXrxV TestUser
- LOGOUT aB6UArhznRMgTtXrxV TestUser 15.06.2006 13:51 15.06.2006 13:51 0 min Hauptbenutzer
- LOGIN aB6UArhznRMgTtXrxV root
- ABMELDEN aB6UArhznRMgTtXrxV root 15.06.2006 14:01 15.06.2006 14:05 3 min
- LOGIN aB6UArhznRMgTtXrxV aradams
- LOGIN ak8-km3bhTZhgYSxxV gesmith
- LOGOUT aB6UArhznRMgTtXrxV aradams 15.06.2006 14:05 15.06.2006 14:06 1 min Basisbenutzer
- LOGOUT ak8-km3bhTZhgYSxxV gesmith 15.06.2006 14:06 15.06.2006 14:10 4 min Basisbenutzer
- Wenn Sie auch den Lizenztyp der Benutzer sehen möchten und Floating-Lizenzen auf eine Benutzergruppe beschränkt werden können, können Sie alle Floating-Schreiblizenzen und deren Benutzer in einen neuen Unterordner namens „Floating-Benutzer“ in der Lizenz- und Berechtigungsstruktur verschieben. Sie können auch den Standardordner „Benutzer“ in „Dedizierte Benutzer“ umbenennen und alle dedizierten Lizenzen dorthin verschieben.