Jump to: navigation, search


Log files are an integral part of Genesys software. They are the main sources of information when troubleshooting application issues. The faster that relevant, accurate, and consistent log files are provided, the sooner an issue can be resolved. Unfortunately, many problems can occur when trying to retrieve the log files necessary for troubleshooting. Common problems include:

  • The log files for the time when the problem occurred have been overwritten or otherwise lost.
  • Log files delivered are not within the event time frame.
  • Log files provided were created with log levels not detailed enough for the investigation.
  • The set of log files provided is inaccurate or incomplete.

The Log File Management Tool utility is intended to minimize these issues, and thereby reduce the time required to resolve customer problems.

LFMT Components

The LFMT has four main components: LFMT Client, LFMT Collector, LFMT Indexer and Workbench Agent.

LFMT Client performs the following functions:

  • Deploys as a plug-in to Genesys Administrator Extension (GAX).
  • Provides a graphical user interface to configure and control the LFMT solution.
    • Schedule log file collections.
    • Configure custom indexing on application log files.
    • Configure masking of sensitive data in application log files.
    • Search, select, and download log files collected by the LFMT Collector.
One LFMT Client can serve multiple LFMT Collector/LFMT Indexer pairs.

LFMT Collector performs the following functions:

  • Deploys on the LFMT Server Host(s).
  • Initiates scheduled and real-time collection requests by the LFMT Client
    • Application hosts are queried for new or modified log files only.
    • Log files are copied from application servers to the LFMT Server Host(s).
    • Log files are compressed for transfer (~10:1).
    • Log files are encrypted for transfer (default is AES128-cbc).
  • Creates log file packages resulting from user queries in the LFMT Client.
  • Masks sensitive data in log file packages created by a user in the LFMT Client.

LFMT Indexer performs the following functions:

  • Deploys on the LFMT Server Host(s).
  • Indexes log files collected by LFMT Collector.
  • Compresses log files for reduced storage.
  • Purges log files based on a user specified retention period.

Workbench Agent performs the following functions:

  • Deploys on the Genesys applications’ hosts
  • Receives scheduled or real-time log collection requests from the LFMT Collector
  • Identifies new or modified log files to be sent to the LFMT Collector
  • Log files can be compressed for transfer based on configuration (review the configuration section <name section>)
  • Log files can be transferred securely or as plain text based on configuration (review the configuration section <name section>)

Supported File Types

The type of log files that can be managed by the LFMT are:

  • Application log files—*.log (including those that have been configured for circular logging)
  • Application snapshot log files that can be opened for writing—*.snapshot.log.
  • Core and dump files created after an application terminates unexpectedly—core.* and dmp.*.
  • Log files from third party applications configured in Configuration Server.
For log files to be accessible by the LFMT, the application must be provisioned in Configuration Server with a configuration option of all set in the [log] section. The value of this option should be set to the absolute path of the application log files.

Comment on this article:

blog comments powered by Disqus
This page was last modified on 18 January 2018, at 14:11.