Zum Inhalt

Protokollierung

Speicherort der Protokolldateien

Zwei Protokolldateien stehen zur Verfügung:

  • <Installationsverzeichnis>/sessionserver/sessionserver.log: Protokolldatei für die Sitzungsserveranwendung.

  • <Installationsverzeichnis>/sessionserver/container.log: Protokolldatei für den Container, der als Host für die Host Access for the Cloud-Anwendung dient.

Konfigurieren der Protokollrotation

Sie können die Protokollrotation durch Bearbeiten der Werte in <Installationsverzeichnis>\sessionserver\microservices\sessionserver\service.yml konfigurieren:

LOGGING_FILE_MAXSIZE 
LOGGING_FILE_MAXHISTORY

Festlegen von Protokollierungsstufen

Es gibt verschiedene Typen von Protokollierungsstufen, mit denen unterschiedliche Arten von Informationen generiert werden können. Sie können den Protokollierumfang in <Installationsverzeichnis>\sessionserver\microservices\sessionserver\service.yml konfigurieren.

Hinweis

Zeilen in service.yml müssen mit Leerzeichen eingerückt werden.

Verwenden Sie zum Festlegen des Protokollierumfangs das folgende Format:

- name: logging.level.<Protokollierung> 
  value: "<Protokollierungsstufe>"

Dabei steht <Protokollierung> für den Namen der anzupassenden Protokollierung, und <Protokollierungsstufe> gibt eine der folgenden Stufen an:

  • Trace – Gibt detailliertere informative Ereignisse an als „Debug“.

  • Debug – Gibt informative Ereignisse auf Detailebene an, die sich besonders für die Fehlersuche bei einer Anwendung eignen.

  • Info – Gibt Informationsmeldungen an, die den Fortschritt der Anwendung auf allgemeiner Ebene hervorheben.

  • Warn – Gibt potenziell gefährliche Situationen an.

  • Error – Gibt Fehlerereignisse an, bei denen die Anwendung trotzdem weiterhin ausgeführt werden könnte.

  • Fatal – Gibt sehr schwerwiegende Fehlerereignisse an, die sehr wahrscheinlich zu einer Beendigung der Anwendung führen.

Hinweis

Nachdem Sie Änderungen an service.yml vorgenommen haben, müssen Sie den Sitzungsserver neu starten.

Aktivieren der Protokollierung vom Webclient zum Sitzungsserver

Der Browser bietet einen einfachen Mechanismus zur Protokollierung in seiner JavaScript-Konsole. Der Webclient erweitert diese Fähigkeit, sodass Sie mit einer entsprechenden Konfiguration Ereignisse auf dem Sitzungsserver protokollieren können, wo sie der Administrator anzeigen kann.

Standardmäßig erfolgt keine Protokollierung auf dem Sitzungsserver. Zum Aktivieren dieser Funktion müssen Sie den Protokollierumfang festlegen, indem Sie die unten aufgeführten Anweisungen befolgen.

Die verfügbaren Einstellungen für den Protokollumfang sind: debug (Fehlersuche), info (Information), warn (Warnung), error (Fehler) und off (keine Protokollierung). Standardmäßige ist der Protokollierumfang auf off eingestellt, d. h. deaktiviert.

Protokollierumfang für alle Webclient-Benutzer anpassen

Um den Protokollierumfang für alle Webclients anzupassen, fügen Sie den folgenden Eintrag zur Datei <Installationsverzeichnis>\sessionserver\microservices\sessionserver\service.ymlhinzu:

- name: <Protokollierer> 
  value: "<Protokollierumfang>"

<Protokollier> ist:

logging.level.com.microfocus.zfe.webclient.core.handler.ClientLoggingHandler-webclient

Hinweis

Gehen Sie mit Bedacht vor, wenn Sie den Protokollierumfang für alle Webclient-Benutzer in einer Produktionsumgebung erhöhen, weil dies den Netzwerkverkehr erhöhen kann.

Protokollierumfang für einen einzelnen Benutzer anpassen

Es gibt zwei Optionen zum Anpassen des Protokollierumfangs für einzelne Benutzer:

  • Um vorübergehend den Protokollierumfang für die Webclient-Instanz eines bestimmten Benutzers anzupassen, ohne den Sitzungsserver neu zu starten, weisen Sie den Benutzer an, beim Laden des Webclients im Browser den folgenden URL-Parameter hinzuzufügen:

    -https://meinssitzungsserver.com:7443/?log=<Protokollierumfang>-

  • Um den Protokollierumfang für einen einzelnen Benutzer anzupassen, ohne dass der Benutzer dazu Änderungen vornehmen muss, fügen Sie den folgenden Eintrag zur Datei service.yml hinzu:

     - name: <Protokollierer> 
       value: "<Protokollierumfang>"
    

<Protokollier> ist:

```java
  logging.level.com.microfocus.zfe.webclient.core.handler.ClientLoggingHandler-webclient-<Benutzername>
```

<Benutzername> ist der Benutzername der Person, für die Sie den Protokollierumfang anpassen möchten.

Hinweis

Zur Protokollierung auf Basis eines Benutzernamens ist ein Authentifizierungsmodus erforderlich, der Benutzernamen verwendet.