Logging configuration

IBM Tivoli Monitoring Agent Builder logging options can be configured after installation. If you are experiencing problems, IBM® Software Support might ask you to configure logging and tracing information. This section explains how to configure the product to provide logging data.

Configuration options

You can configure trace logging by using the IBM Java Logging Toolkit to set the trace level for the appropriate component of the IBM Tivoli® Monitoring Agent Builder.

IBM Java Logging Toolkit

You can perform all logging configuration in the IBM Java Logging Toolkit. Access the Eclipse preference window by performing the following steps:

  1. Select Window - Preferences to display the Window toolbar menu.
  2. Click IBM Java Logging Toolkit to display the IBM Java Logging Toolkit window.

    The Logger Configuration table displays the trace configuration for the following components:

    JLog
    IBM Tivoli Monitoring Logger Trace Logger
    KQZGeneratorTrace
    IBM Tivoli Monitoring Generator Trace Logger
    KQZTrace
    IBM Tivoli Monitoring Agent Builder Trace Logger

    The trace level for each component can be set independently to one of the following values. Selecting a trace level causes trace entries of that level and all higher levels to be included in the log file.

    • Error - Error messages.
    • Warning - Warnings.
    • Information - Informational messages.
    • Minimum - The Minimum level of tracing provides some information about the program state with only a minimal impact on the performance of the program.
    • Medium - The Medium level of tracing follows the paths of some high-level APIs and their parameters.
    • Maximum - The Maximum level of tracing follows the paths of most of the code and provide a detailed program flow.

    Logging for each component can also be enabled or disabled by selecting On or Off for Logging.

  3. By expanding the IBM Java Logging Toolkit you can set the following Trace Attributes for each component:
    • Log file Directory
    • Maximum number of revolving trace files
    • Maximum size of each trace file (in KB)
    • Enable trace logging to files
    • Enable trace logging to console
    • Restore Defaults
Output window

Use the appropriate output windows to customize the trace file settings. Access the Eclipse output page by doing the following:

  1. Click Window to display the Window toolbar menu.
  2. Click Preferences to display the Preferences window.
  3. Click the plus sign next to the IBM Java Logging Toolkit to display the output windows.
  4. Click the appropriate output window to display the output settings for that component.

The window displays the following information:

Log file directory
Specifies the location of the log file directory.
Maximum number of revolving trace files
Specifies the number of trace files that will be used and reused to store the trace data.
Maximum size of each trace file (in Kilobytes)
Specifies the maximum size in KB for each of the revolving trace files.
Enable trace logging to files
(Optional) Check this box to store the trace logging data.
Enable logging to console
(Optional) Check this box to send logging information to a development console.
Note:
If you enable this option, you must restart the IBM Tivoli Monitoring Agent Builder as described in the following procedure:
  1. Close the IBM Tivoli Monitoring Agent Builder.
  2. Modify the install_dir/agentbuilder.ini file.
    • On Windows systems, change install_dir/_jre/jre/bin/javaw.exe to install_dir/_jre/jre/bin/java.exe.
    • On Linux or AIX® systems, change install_dir/_jre/jre/bin/javaw to install_dir/_jre/jre/bin/java.
  3. Relaunch the IBM Tivoli Monitoring Agent Builder.