Logging broker activity

About this task

Broker session activity is saved to the broker log files. These files are named using the following format.

TRCICB-computername-suffix.log

where computername is the computer name of the broker and suffix is determined by the LogRotation and LogRollover settings.

For example, TRCICB-RCBROKER.example.com-Tue.log

The broker log files are located in the \Broker directory within the brokers’s working directory.

In a Windows system, the file is located in \ProgramData\BigFix\Remote Control\Broker\. In Linux the file is located in the /var/opt/bigfix/trc/broker directory.

Use the following properties to configure the logging level and how often the broker log file is renewed.
Logging level
Set the required logging level. The logging level determines the types of entries and how much information is added to the broker log file. Default value is 2.
A two column table giving the Logging level parameter values and definitions
Logging Level Description
0 no logging
1 error
2 info
4 debug information
LogRotation
Controls the period after which an older log file will be overwritten. Log rotation can be disabled. Default value is Weekly.
A four column table giving the LogRotation parameter values and their definitions.
LogRotation Description Suffix for hourly rollover Suffix for daily rollover
Daily Overwrite log files after one day 00H to 23H Not valid
Weekly Overwrite log files after one week. Mon-00H to Sun-23H Mon - Sun
Monthly Overwrite log files after one month. 01-00H to 31-23H 01 to 31
Disabled LogRotation is disabled YYYY-MM-DD-hh YYYY-MM-DD
LogRollOver
Controls the period after which a new log file is started. This period has to be smaller than the LogRotation period, therefore not all combinations are valid. LogRollover cannot be disabled. Default value is Daily.
A three column table giving the LogRollover parameter values and their definitions.
LogRollover Description Comments
Hourly Start a new log file on the hour. Recommended for busy brokers or when using log levels higher than 2.
Daily Start a new log file every day. Default setting.
LogRollover Description Comments

Procedure

To configure logging complete the following steps:
  1. Configure the following properties within the trc_broker.properties file.

    For more information about the properties, see Properties for configuring logging activity

    LogLevel
    Set the required logging level.

    The log level determines the types of entries and how much information is added to the log file. Default value is 2.

    LogRotation

    Controls the period after which an older log file is overwritten. Log rotation can be disabled. Default value is Weekly.

    LogRollOver

    Controls the period after which a new log file is started. This period must be shorter than the LogRotation period, therefore not all combinations are valid. LogRollover cannot be disabled. Default value is Daily.

  2. Save the file.