Changing activity logging settings

Use the Activity Logging option to enable or disable log files that monitor various system activities.

About this task

When you enable activity logging settings, IBM Security Identity Governance and Intelligence maintains a log file,adapterAGNT.log, of all transactions. By default, the log file is in the read/write log directory.

Procedure

  1. Access the Agent Main Configuration Menu.
  2. At the Main menu prompt, type E to display the Agent Activity Logging Menu.
    The following screen displays the default activity logging settings.
    Agent Activity Logging Menu
    -------------------------------------	
    A. Activity Logging (Enabled).
    B. Logging Directory (current: /var/ibm/adapter_readwritedir/log).
    C. Activity Log File Name (current: adapterAGNT.log).
    D. Activity Logging Max. File Size ( 1 mbytes)
    E. Activity Logging Max. Files ( 3 )
    F. Debug Logging (Enabled).
    G. Detail Logging (Disabled).
    H. Base Logging (Disabled).
    I. Thread Logging (Disabled).
    X. Done
    Select menu option:	
  3. Type the letter of the preferred menu option
    Note: Ensure that Option A is enabled for the values of other options to take effect.
    • Press Enter to change the value for menu option B, C, D, or E. The other options are changed automatically when you type the corresponding letter of the menu option. Table 1 describes each option.
    • Press Enter to return to the Agent Activity Logging Menu without changing the value.
    Table 1. Options for the activity logging menu
    Option Configuration task
    A Set this option to Enabled for the adapter to maintain a dated log file of all transactions.

    Type A to toggle between the options.

    B
    Displays the following prompt:
    Enter log file directory:

    Type a different value for the logging directory, for example, /home/Log. When the logging option is enabled, details about each access request are stored in the logging file that is in this directory.

    C
    Displays the following prompt:
    Enter log file name:

    Type a different value for the log file name. When the logging option is enabled, details about each access request are stored in the logging file.

    D
    Displays the following prompt:
    Enter maximum size of log files (mbytes):

    Type a new value, for example, 10. The oldest data is archived when the log file reaches the maximum file size. File size is measured in megabytes. It is possible for the activity log file size to exceed the disk capacity.

    E
    Displays the following prompt:
    Enter maximum number of log files to retain:

    Type a new value up to 99, for example, 5. The adapter automatically deletes the oldest activity logs beyond the specified limit.

    F If this option is set to enabled, the adapter includes the debug statements in the log file of all transactions.

    Type F to toggle between the options.

    G

    If this option is set to enabled, the adapter maintains a detailed log file of all transactions. The detail logging option must be used for diagnostic purposes only. Detailed logging enables more messages from the adapter and might increase the size of the logs.

    Type G to toggle between the options.

    H

    If this option is set to enabled, the adapter maintains a log file of all transactions in the Agent Development Kit (ADK) and library files. Base logging substantially increases the size of the logs.

    Type H to toggle between the options.

    I

    If this option is enabled, the log file contains thread IDs, in addition to a date and timestamp on each line of the file.

    Type I to toggle between the options.