action.skip

Logging

Viewing and downloading log files is accomplished on the Cluster Management console.

Locating log files

To view or download log files:

  1. Log in to the MSS Admin Console at https://hostname/adminconsole.

  2. From the drop-down menu, click Cluster Management.

  3. Click Services, and find the hacloud-session-server service.

  4. Click that service to view the application instances (pods) across the cluster.

  5. Click ellipsis and then click either

    • View Recent Logs - to view the last 500 entries logged in a browser window.

    • Download Logs - to download the entirety of all the log files

    • Redeploy - to redeploy the service instance. This will affect any users connected to the service.

Setting logging levels

There are various types of logging levels you can use to produce different types of information. You configure logging levels by editing the service's properties in the Cluster Management console.

Use the following format to set logging levels:

Key Value
logging.level.logger log level

Where logger is the name of the logger to adjust and log level is one of the following:

  • Trace - designates finer-grained informational events than Debug

  • Debug - designates fine-grained informational events that are most useful to debug an application.

  • Info -designates informational messages that highlight the progress of the application at coarse-grained level.

  • Warn - designates potentially harmful situations.

  • Error - designates error events that might still allow the application to continue running.

  • Fatal - designates very severe error events that will presumably lead the application to terminate.

Enabling Web client-to-session server logging

While the browser provides a basic mechanism for logging to its JavaScript console, the Web Client extends this capability and, with some configuration, you can log events to the service for viewing by an administrator.

By default, nothing is logged to the session server. You must set the log level, following the instructions below, in order to enable this feature.

The available log levels are: debug, info, warn, error, or off. The default log level is off.

Adjusting the logging level for all Web client users

To adjust the logging level for all Web clients, add the following property to the service

Key Value
logging.level.com.microfocus.zfe.webclient.core.handler.ClientLoggingHandler-webclient log level

note

Use caution when increasing the logging level for all Web Client users in a production environment due to a potential increase in network traffic.

Adjusting the logging level for an individual user

There are two options for adjusting the logging level for individual users:

  • To temporarily adjust the logging level for a particular user’s Web client instance without requiring a session server restart, instruct the user to add the following URL parameter when loading the Web client in their browser:

    -https://<clusterdns>/webclient?log=<log level>-

  • To adjust the logging level for an individual user without requiring them to make changes, follow these directions, Adjusting Advanced Product Settings, using these values:

    Key Value
    logging.level.com.microfocus.zfe.webclient.core.handler.ClientLoggingHandler-webclient-username log level

    and where username is the user name of the person whose logging levels you are adjusting.

note

Logging based on a username requires an authentication mode that involves usernames.