Writing Activity Logs to files

You can define a configurable service of type ActivityLog to write your Activity Logs to a file system. Configure the service to capture the Activity Log data that you are interested in.

About this task

Use the filtering capabilities of this feature to customize the log content and make it relevant to your needs. You can configure the size and number of log files and the criteria by which the log rotates from one file to the next. You can also identify the location and file name of the log files.

You can use the ActivityLog configurable service to configure the following Activity Log file characteristics:

  • Whether file logging is enabled
  • The maximum number of files used for each log
  • The maximum size of the log files (before the log rotates to the next file)
  • The maximum age of the log files (before the log rotates to the next file)
  • Filters that determine the content of the logs
  • The severity levels of messages logged
  • The log path and file name
  • Whether messages are formatted with inserts included in the message text
  • The scope of the configurable service (which integration server it applies to)

For more information about the properties that can be set and their possible values, see ActivityLog configurable service. The scope of the settings is the integration server. For example, if you set the numberOfLogs property to 5, each integration server has a maximum of five files for its Activity Log.

The files are in UTF-8 format.

Procedure

To define and customize the configurable service, perform the following steps:

  1. Define a configurable service of type ActivityLog.
    You can define the configurable service by using the web user interface or the mqsicreateconfigurableservice command.
  2. Optional: Use the mqsireportproperties and the mqsichangeproperties commands to view and modify the Activity Log file properties.