Der folgende Artikel beschreibt, wo Sie die Protokolldateien der IGEL Universal Management Suite (UMS) finden und konfigurieren können.

Wie Sie die Protokollierung der Aktionen des UMS Benutzers und der von einem Gerät gestarteten Aktionen aktivieren können, erfahren Sie unter Logging.

Wenn Sie IGEL OS 12-Geräte verwalten, siehe Debugging / How to Collect Log Files.

Wenn Sie UMS Protokolldateien für den IGEL Support benötigen, lesen Sie Supportinformationen speichern / Logdateien an den Support senden


UMS 12.01 oder höher

Um die Logging-Einstellungen für UMS 12.01 oder höher zu ändern, lesen Sie die Datei README.md unter [IGEL Installationsverzeichnis]/RemoteManager/rmguiserver/logs.

Wenn Sie die Logging-Konfiguration ändern, ist ein Neustart des UMS Servers nicht erforderlich.

UMS Server

rmguiserver/logs
(Lesen Sie rmguiserver/logs/README.md für die Konfiguration der Protokolle)

stderr.logFehlermeldung des Apache Tomcat Servers
stdout.logStandardausgabe des Apache Tomcat Servers
ums-api.logProtokollierung des API-Dienstes

ums-server.log (= catalina.log vor UMS 12)

ums-server-err.log

Zentrale Protokolldatei für alle protokollierten Ereignisse

device-connector.log

device-connector-err.log

Protokollierung von Device Connector

ums-device-service.log

ums-device-service-err.log

Protokollierung der OS 12-Gerätefunktionalität

ums-appproxy.log​

ums-appproxy-err.log​

Protokollierung von UMS as an Update Proxy

rmguiserver/logs/ums-server
(rmguiserver/conf/logback.xml -  für die Konfiguration der Protokolle)
ums-server-msg.log

Protokollierung des Apache ActiveMQ-Messaging (High Availability und Distributed UMS)

ums-server-communication.log

Protokollierung der Kommunikation mit der UMS Konsole oder den Geräten
Editieren bei  <!-- Logging of UMS communication -->

ums-server-threaddump.log

Periodische Protokollierung der Threads

ums-server-icg-communication.log

Protokollierung der Kommunikation mit dem ICG
Editieren bei  <!-- Logging of UMS communication --> 

ums-server-health.log

Protokollierung der UMS HA Statusprüfung

ums-server-monitoring.log

Protokollierung der Leistungsaufzeichnung
Editieren bei  <!-- Logging of monitoring data -->; ersetzen Sie INFO durch DEBUG, um detaillierte Informationen zu jedem Methodenaufruf zu erhalten

Dies ist ein Beispiel für die Datei rmguiserver/conf/logback.xml, in der Sie die Logs für den UMS Server konfigurieren können, d. h. die Protokollierung ein- und ausschalten, den Scan-Zeitraum oder die Anzahl der Tage für die Protokollierungshistorie ändern, usw:

<?xml version="1.0" encoding="UTF-8"?>

-<configuration scanPeriod="60 seconds" scan="true" debug="false">


<!-- The length of logging history in days -->

<property value="30" name="logs.history"/>


<!-- The maximum size of one log file -->

<property value="100MB" name="logs.maxsize"/>


<!-- The maximum size of the history -->

<property value="1GB" name="logs.historysizecap"/>


<!-- Logging of monitoring data -->

<!-- Elevate to 'DEBUG' to see the individual calls -->

<property value="INFO" name="monitoring.level"/>


<!-- Logging of UMS communication -->

<!-- Set to 'ALL' to enable and 'OFF' to disable -->

<property value="OFF" name="server2console.level"/>

<property value="OFF" name="server2tc.level"/>

<property value="OFF" name="server2usg.level"/>

<property value="OFF" name="usg2server.level"/>

<property value="OFF" name="server2server.level"/>


<!-- Logging level of domain service -->

<!-- OFF, INFO, DEBUG, ERROR -->

<property value="WARN" name="domainservicelog.level"/>

<!-- The appenders -->

rmguiserver/logs/unifiedprotocol

communication.log

Protokollierung der Kommunikation zwischen dem Gerät und der UMS (eingehende und ausgehende Befehle)

Editieren Sie rmguiserver/webapps/device-connector/WEB-INF/classes/config/logback.xml, um die Protokolle zu konfigurieren.

Editieren bei <!-- Logging of device communication -->; ersetzen Sie OFF durch INFO für die Protokollierung von Befehlsköpfen oder durch ALL für die Protokollierung von Befehlsköpfen und Nutzdaten

domain-service.log

Zentrale Protokolldatei für alle Ereignisse in der Befehlsbehandlung

Editieren Sie rmguiserver/conf/logback.xml, um die Protokolle zu konfigurieren.

Editieren bei <!-- Logging level of domain service -->

device-auth.log

Protokollierung von Problemen bei Onboarding der Geräte und Geräteauthentifizierung

UMS Load Balancer

umsbroker/etc/work/logs
(umsbroker/etc/conf/logback.xml -  für die Konfiguration der Protokolle)
ums-broker.logZentrale Protokolldatei für alle protokollierten Ereignisse
ums-broker-msg.logProtokollierung der ausgetauschten Nachrichten
ums-broker-health.logProtokollierung der UMS HA Statusprüfung
ums-broker-monitoring.log

Protokollierung der Leistungsaufzeichnung
Editieren bei  <!-- Logging of monitoring data -->; ersetzen Sie INFO durch DEBUG, um detaillierte Informationen zu jedem Methodenaufruf zu erhalten

UMS Watchdog

umswatchdog/etc/work/logs
(umswatchdog/etc/conf/logback.xml - für die Konfiguration der Protokolle)
ums-watchdog.logZentrale Protokolldatei für alle protokollierten Ereignisse
ums-watchdog-msg.logProtokollierung der ausgetauschten Nachrichten
ums-watchdog-health.logProtokollierung der UMS HA Statusprüfung

UMS Konsole

$HOME/.igel
RMClient.exe.logStartprotokollierung
$HOME/.igel/logs
(rmclient/logback.xml -  für die Konfiguration der Protokolle)
ums-console.logZentrale Protokolldatei für alle protokollierten Ereignisse

UMS Administrator

$HOME/.igel
RMAdmin.exe.logStartprotokollierung
rmguiserver/logs
(rmadmin/logback.xml -  für die Konfiguration der Protokolle)
ums-admin.logZentrale Protokolldatei für alle protokollierten Ereignisse

UMS 6.10.110 und höher

In UMS Version 6.10.110 wurde das veraltete Logging-Framework Log4j 1.x durch Logback ersetzt; siehe auch ISN 2022-19: Log4j 1.x Remainder in UMS.

Um die Logging-Einstellungen für UMS 6.10.110 oder höher zu ändern, verwenden Sie logback.xml.

UMS Server

rmguiserver/logs
(rmguiserver/conf/logback.xml - für die Konfiguration der Protokolle)

catalina.log

Zentrale Protokolldatei für alle protokollierten Ereignisse

ums-server-msg.log

Protokollierung des Apache ActiveMQ-Messaging

ums-server-communication.log

Protokollierung der Kommunikation mit der UMS Konsole oder den Geräten
Editieren bei  <!-- Logging of UMS communication -->

localhost.logTechnische Protokollierung des Apache Tomcat Servers
stderr.logFehlermeldung des Apache Tomcat Servers
stdout.logStandardausgabe des Apache Tomcat Servers

ums-server-threaddump.log

Periodische Protokollierung der Threads

ums-server-icg-communication.log

Protokollierung der Kommunikation mit dem ICG
Editieren bei  <!-- Logging of UMS communication --> 

ums-server-health.log

Protokollierung der UMS HA Statusprüfung

ums-server-monitoring.log

Protokollierung der Leistungsaufzeichnung
Editieren bei  <!-- Logging of monitoring data -->; ersetzen Sie INFO durch DEBUG, um detaillierte Informationen zu jedem Methodenaufruf zu erhalten (ein Neustart des Servers ist dann erforderlich)

Dies ist ein Beispiel für die Datei rmguiserver/conf/logback.xml, in der Sie die Logs für den UMS Server konfigurieren können, d. h. die Protokollierung ein- und ausschalten, den Scan-Zeitraum oder die Anzahl der Tage für die Protokollierungshistorie ändern, usw:

<?xml version="1.0" encoding="UTF-8"?>
<configuration debug="false" scan="true" scanPeriod="60 seconds">

<!-- General settings -->


<!-- Logging of monitoring data -->
<!-- Elevate to 'DEBUG' to see the individual calls -->
<property name="monitoring.level" value="INFO" />

<!-- Logging of UMS communication -->
<!-- Set to 'ALL' to enable and 'OFF' to disable -->
<property name="server2console.level" value="OFF" />
<property name="server2tc.level" value="OFF" />
<property name="server2usg.level" value="OFF" />
<property name="usg2server.level" value="OFF" />


<!-- The base folder for log files -->
<property name="base.dir" value="${catalina.home}/logs" />

<!-- The default logging pattern -->
<property name="pattern.format" value="%-5(%d{[yyyy-MM-dd HH:mm:ss.SSS]}) %-5level [%thread] %logger{10}.%M - %msg%n" />

<!-- The length of logging history in days -->
<property name="logs.history" value="30" />


<!-- The appenders -->


rmguiserver/logs
(rmguiserver/conf/logback.xml - für die Konfiguration der Protokolle)

ums-api.log

Protokollierung des API-Dienstes

UMS Load Balancer

umsbroker/etc/work/logs
(umsbroker/etc/conf/logback.xml - für die Konfiguration der Protokolle)
ums-broker.logZentrale Protokolldatei für alle protokollierten Ereignisse
ums-broker-msg.logProtokollierung der ausgetauschten Nachrichten
ums-broker-health.logProtokollierung der UMS HA Statusprüfung
ums-broker-monitoring.log

Protokollierung der Leistungsaufzeichnung
Editieren bei  <!-- Logging of monitoring data -->; ersetzen Sie INFO durch DEBUG, um detaillierte Informationen zu jedem Methodenaufruf zu erhalten (ein Neustart des Servers ist dann erforderlich)

UMS Watchdog

umswatchdog/etc/work/logs
(umswatchdog/etc/conf/logback.xml - für die Konfiguration der Protokolle)
ums-watchdog.logZentrale Protokolldatei für alle protokollierten Ereignisse
ums-watchdog-msg.logProtokollierung der ausgetauschten Nachrichten
ums-watchdog-health.logProtokollierung der UMS HA Statusprüfung

UMS Konsole

$HOME/.igel
RMClient.exe.logStartprotokollierung
$HOME/.igel/logs
(rmclient/logback.xml - für die Konfiguration der Protokolle)
ums-console.logZentrale Protokolldatei für alle protokollierten Ereignisse

UMS Administrator

$HOME/.igel
RMAdmin.exe.logStartprotokollierung
rmguiserver/logs
(rmadmin/logback.xml - für die Konfiguration der Protokolle)
ums-admin.logZentrale Protokolldatei für alle protokollierten Ereignisse

Vor UMS 6.10.110

UMS Server

rmguiserver/logs
(rmguiserver/conf/log4j.properties - für die Konfiguration der Protokolle)

catalina.log

Zentrale Protokolldatei für alle protokollierten Ereignisse

ums-server-msg.log

Protokollierung des Apache ActiveMQ-Messaging

communication.log

Protokollierung der Kommunikation mit der UMS Konsole oder den Geräten
Editieren bei # communication logging - define the log levels; siehe Log4j-Dokumentation

license_deployment.logLizenzprotokollierung
Editieren bei # license deployment logging; siehe Log4j-Dokumentation
localhost.logTechnische Protokollierung des Apache Tomcat Servers
stderr.logFehlermeldung des Apache Tomcat Servers
stdout.logStandardausgabe des Apache Tomcat Servers
umsthreaddump.logPeriodische Protokollierung der Threads
Editieren bei # threaddump logging; siehe Log4j-Dokumentation
usgcommunication.log

Protokollierung der Kommunikation mit dem ICG
Editieren bei # communication logging - define the log levels; siehe Log4j-Dokumentation

health.logProtokollierung der UMS HA Statusprüfung
monitoring.log

Protokollierung der Leistungsaufzeichnung
Editieren bei # execution monitoring; ersetzen Sie INFO durch DEBUG, um detaillierte Informationen zu jedem Methodenaufruf zu erhalten (ein Neustart des Servers ist dann erforderlich)

rmguiserver/logs
(rmguiserver/conf/log4japi.properties - für die Konfiguration der Protokolle)
api.logProtokollierung des API-Dienstes

UMS Load Balancer

umsbroker/etc/work/logs
(umsbroker/etc/conf/log4j.properties - für die Konfiguration der Protokolle)
igel-ums-broker.logZentrale Protokolldatei für alle protokollierten Ereignisse
broker-msg.logProtokollierung der ausgetauschten Nachrichten
broker-health.logProtokollierung der UMS HA Statusprüfung
broker-monitoring.log

Protokollierung der Leistungsaufzeichnung
Editieren bei # monitoring logging; ersetzen Sie INFO durch DEBUG, um detaillierte Informationen zu jedem Methodenaufruf zu erhalten (ein Neustart des Servers ist dann erforderlich)

UMS Watchdog

umswatchdog/etc/work/logs
(umswatchdog/etc/conf/log4j.properties - für die Konfiguration der Protokolle)
igel-ums-watchdog.logZentrale Protokolldatei für alle protokollierten Ereignisse
watchdog-msg.logProtokollierung der ausgetauschten Nachrichten
watchdog-health.logProtokollierung der UMS HA Statusprüfung

UMS Konsole

$HOME/.igel
RMClient.exe.logStartprotokollierung
$HOME/.igel/logs
(rmclient/log4j.properties - für die Konfiguration der Protokolle)
igel-ums-console.logZentrale Protokolldatei für alle protokollierten Ereignisse

UMS Administrator

$HOME/.igel
RMAdmin.exe.logStartprotokollierung
rmguiserver/logs
(rmadmin/log4j.properties - für die Konfiguration der Protokolle)
igel-ums-admin.logZentrale Protokolldatei für alle protokollierten Ereignisse