Docker Log File Management
  • 26 Jun 2023
  • 3 Minutes to read
  • Contributors
  • Dark
    Light
  • PDF

Docker Log File Management

  • Dark
    Light
  • PDF

Article summary

Log File Locations

Functional Logs

Auditing Logs

These are logs related to the actions performed by users in the web interface and as well as logs of requests made on the web services REST API.

The following are examples of user actions that are registered in the log:

  • Successful login
  • Addition of a network element
  • Request for a manual resync of a network element.

As an administrator, you may find it useful to view this log for various reasons.

For example:

  • To investigate who accessed or tried to access the appliance
  • To troubleshoot issues a user is experiencing while using the appliance
  • To determine whether a user action was accomplished successfully
  • To determine which user made a change to any stored information, such as a Skylight device configuration.


Note: Only user actions and API requests are logged. Actions initiated by the system, by an automatic trigger, or by a resync are not logged.

The log file is stored in the following directory:

${volume-location so-logs}/bizn1/bizn1instance/auditing_business.log

Backup Database Logs

The file is located in the following directory:

${volume-location so-logs}/bizn1/bizn1instance/all.log

Other

  • Logs related to the Session management and the interaction between the Supervision Endpoint

    The file is located in the following directory:
    ${volume-location so-logs}/bizn1/bizn1instance/sdmm.log

  • Logs related to the interaction with the Devices

    The file is located in the following directory:
    ${volume-location so-logs}/mednX/mednXinstance/all.log
    Where X is a mediation number from 1-12

Redundancy Logs

The redundancy feature writes a log of activity and error messages.

The log file that contains entries about redundancy is located in the following directory on the appliance for the active site:

${volume-location so-logs}/hamon/hamon.log

CLI manager Logs

Writes a log of activity and error messages related to the climanager.

You can find the log file that contains entries about the climanager located in the following directory on the appliance:

/home/skylight/so/bin/logs/clibase.log

Upgrade Logs

The upgrade feature writes a log of activity and error messages.

You can find the log file that contains entries about the upgrade located in the following directory on the Skylight orchestrator appliance:

/home/skylight/docker-dist.log

Deployment Profile Configuration Logs

The deployment feature writes a log of activity and error messages.

You can find the log file that contains entries about deployment located in the following directory on the Skylight orchestrator appliance:

${volume-location so-logs}/skylight/deploymenttool.log

Managing Logs

When solving issues for clients, Accedian Technical Support may require the server log files produced by Skylight orchestrator. They will occasionally require logs that are finer-grained than the logs usually produced by Skylight orchestrator.
These are the log levels that are available (in order of increasing detail):

  • SEVERE - produces the fewest log entries
  • WARNING
  • INFO
  • CONFIG
  • FINE
  • FINER
  • FINEST
  • ALL - produces the most log entries.

Changing the Log Level

To change the log files

  1. Open an SSH terminal session to the Skylight orchestrator CLI on port 2200.

  2. At the Skylight prompt, enter: shell container core
    You are brought to the appliance’s OS-level shell.

  3. Connect to Glassfish as an administrator by entering:
    cd /opt/accedian/skylight/glassfish5/bin
    ./asadmin --port=5048

    The asadmin prompt is displayed.

  4. List the logging level of each module by entering:
    list-log-levels bizcluster
    list-log-levels medcluster

  5. Change the log level by entering commands similar to the following example (which sets the log level to FINE):
    set-log-levels --target bizcluster com.accedian.ems.ecf.server.request.MgmtRequestLogger=FINE
    set-log-levels --target medcluster com.accedian.ems.ecf.server.request.MgmtRequestLogger=FINE

    where: com.accedian.ems.ecf.server.request.MgmtRequestLogger is the logger module.

  6. Terminate the admin session by entering:
    quit

Rotating the Log Files

It is possible to close the log files (server.log, all.log, thirdParty.log), mark them with the current time and start fresh logs. Rotating the log files in this way may be useful if you want to reduce the amount of data to inspect when performing system tests. In addition, starting new log files may be necessary when using finer log levels because they produce large files.

To rotate the log files

  1. Open an SSH terminal session to the Skylight orchestrator CLI on port 2200.

  2. At the Skylight prompt, enter: shell container core
    You are brought to the appliance’s OS-level shell.

  3. Connect to Glassfish as an administrator by entering:
    cd /opt/accedian/skylight/glassfish/bin
    ./asadmin --port=5048

    The asadmin prompt is displayed.

  4. Save the current log files and start new logs by entering:
    rotate-log --target bizcluster
    rotate-log --target medcluster

  5. Terminate the asadmin session by entering:
    quit

Old log files have been closed; file names now include a timestamp and new logs are created.

Normal Log Levels

This section lists the normal log levels for Skylight orchestrator modules. When the intervention on the appliance is finished, the logging levels should be changed back to their normal levels.
46.png
47.png
48.png

© 2024 Accedian Networks Inc. All rights reserved. Accedian®, Accedian Networks®,  the Accedian logo™, Skylight™, Skylight Interceptor™ and per-packet intel™, are trademarks or registered trademarks of Accedian Networks Inc. To view a list of Accedian trademarks visit: http://accedian.com/legal/trademarks/. 


Was this article helpful?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.