This documentation supports the 9.1 version of Remedy Action Request System.

To view the latest version, select the version from the Product version menu.

Configuring the Log Settings page

Use the Log Settings page to update logging configuration settings. A bold label with an asterisk indicates a required field.

BMC Remedy Mid Tier Configuration Tool – Log Settings page
(Click the image to expand it.)

Note

The default values for Log Categories and Maximum Number of Log Files have changed for version 8.1.01 and later. The figure displays the default values for earlier versions. For the new default values of these parameters, see the following table.

Logging

The following table lists the log settings:

SettingDescription
Log Categories

The type of information to be stored in the log file:

  • Reporting – Messages related to reporting.
  • Cache – Messages related to definitions, such as forms and active links in the cache.
  • Session Management – Messages related to user session construction and expiration, such as login, logout, or timeout.
  • Configuration – Messages related to the config.properties file, such as when it is loaded and changed.
  • Flashboards – Messages related to Flashboards.
  • Web Services – Messages related to web services.
  • Field – Messages related to fields.
  • Workflow – Messages related to compilation of workflow (primarily active link actions), such as invalid active links.
  • Performance – Messages related to performance, including duration of operations.
  • Qualifications and Expressions – Messages related to parsing and compilation of expressions, for example, in active links.
  • Servlet – Messages related to servlet handling of http requests, primarily for reporting results of back-channel requests.
  • Internal – Internal logging messages.
  • ARServer (API/Filter/Database) – Messages related to APIs, filters, and databases. Selecting the ARServer (API/Filter/Database) option, overrides the API logging option and all API logging is redirected to the mid tier log file.
  • Data Visualization Module – Messages related to the data visualization module.

All categories except Flashboards are selected by default.

Filter Log by User Name

The user names of those users whose activity is logged. You can restrict the logging for one user or multiple users. To restrict logs for multiple users, specify each user name separated by a semicolon, for example, Alan;Jonnie. See Restricting BMC Remedy Mid Tier logs for multiple users. If you leave the field blank, logs for all users in the current session are recorded.

When you enter one or more user names and save changes, a new log file is started. For log messages displayed on the screen, the filter applies only to new entries. Any existing entries for earlier users are still displayed on the screen until the limit set in the View Logs setting is reached.

Log DirectoryThe directory in which log files are stored, for example, ARSystemInstallDir/Logs. To change the log directory, enter the absolute (complete) path for the new directory. You cannot change the log file name.
Maximum Log File Size (kb)The maximum size (in kilobytes) a file can reach before a backup copy is automatically made. The default size is 1024 KB. The backup copy is made with the same file name (the default is armidtier.log) and an incremental number (for example, armidtierN.log).
Maximum Number of Log Files

The maximum number of backup files that the system will generate when the log file size exceeds the limit specified in the Maximum Log File Size.

The default value is 100 backups.

Log Level

The level of detail for logging information:

  • Fine – The highest level of detail.
  • Info – Less detail than Fine.
  • Warning – A moderate level of detail (the default setting). Warnings plus those errors included in the Severe level are logged.
  • Severe – The lowest level of detail; only server start time and error messages are logged.

You can see the pre-load start and end timestamp when you set the log level to Info or Warning. Irrespective of the logging level, mid tier logs the pre-load start and end time.

The default value is Severe.

Log Viewer

The method by which you want to view log files:

  • Console – The log entries are directed to the stderr (System.err) of your servlet engine.
  • File – Data is saved to a file in the specified log directory.

The default value is File.

Log Format

The log output is generated using the standard Java 1.5 logging API, including Simple and XML formatting:

  • Simple Text (the default) – A basic text file for faster performance. It does not include stack trace information except in the case of Severe log messages.
  • Detailed Text – A text file containing details such as Java class names and methods.
  • XML – A file in XML format.

Mid-Tier Profiler

To activate the Mid-Tier Profiler, set the value of Mid-Tier profiling to True. Mid-Tier Profiler provides the performance information about the client side (JavaScript) code on the mid tier. The profiler shows how much time was spent on a particular method (such as a table refresh). When the profiler is turned on, Show Profile and Clear Profile buttons appear in the mid tier toolbar (if enabled) when forms are viewed in the browser. 

SettingDescription
Show ProfileDisplays all the profiled data.
Clear ProfileClear all the profiled data from memory.
Save Changes Saves the selected value. 
Reset DefaultsChanges the value to the default of True. 

Warning

The Mid-Tier Profiling option is normally used during development of an application because when you turn on the profiler, all users have access to the profile.

Important

Changing this value requires that you restart the web server. 

View logs 

You can view the log files that record the activity of the mid tier. If you have no log files generated, it might be because the Log Viewer setting is set to Console. Change this setting to Files to generate mid tier log files.

The following table lists the log file view settings:

SettingDescription

Display Last

The number of lines that you want to view from the most recent entries in the log. The default is 25.

View Log File

Click to view the log file.

Restricting BMC Remedy Mid Tier logs for multiple users

BMC Remedy Mid Tier logging provides the functionality to restrict the logs based on multiple users at the same time. By restricting the logging to one or more users, you can generate log files containing details of the activity performed only by the specified users.

To restrict BMC Remedy Mid Tier logs for multiple users

  1. Open the BMC Remedy Mid Tier - Configuration Tool.
  2. Go to the Log Settings page. 

  3. In the Filter Log by User Name field, enter the names of the user for restricting the logging.

    To restrict the the log for multiple users, specify the user names as semicolon (;) separated values; for example, Allen;John.
  4. Click Save.

    The log file records the activity performed only by the specified users.

Was this page helpful? Yes No Submitting... Thank you

Comments