Configuring AR System server logging
You can configure the AR System server logging by applying restrictions such that the log files capture only the required information.This topic provides the following information:
Concept of AR System server logging restrictions
You can restrict the AR System server logging based on one or more parameters. For each parameter, you can specify one or more values. To restrict the AR System server logging, use the Log Filtering tab on the Server Information form in the BMC Remedy AR System Administration console.
The following video (7:18) provides information about the concept and benefits of this feature. The video also demonstrates the method apply the logging restrictions.
The video is recorded using the earlier version of BMC Remedy AR System and is valid for BMC Remedy AR System 9.1 and later versions.
The following table lists the restrictions that you can apply to AR System server logging:
|New parameter in the ar.cfg (or ar.conf) file
A list of semicolon separated users names. Restricts logs only for specified users.
For example, Allen;Mike
A list of semicolon separated client types (or IDs if the client type is not known). Restricts logs only for specified client types.
For example, Mid-tier;Developer Studio;Remedy Administrator
Important: Ensure that you use valid values for the Client Type. If you enter an incorrect value, the restriction will not be applied.
List of valid values for Client Type
A list of semicolon separated RPC Queue IDs. Restrictions are applied to the API, SQL, and Filter logs only for specified RPC Queues.
For example, 390600;390680;390620
The arsql.log, arapi.log, and arfilter.log are the default log files that record the activities based on the restrictions; however, you can change the name of the log file that is generated.
The Restrict-Logging parameter is added to the ar.cfg (ar.conf) file. The following table lists the possible values of Restrict-Logging parameter:
|Value of Restrict-Logging parameter
The Restrict-Logging parameter controls which type of logging restriction is enabled. You can have combinations of Users, Client Type, and RPC Queues restrictions. For example, if you select Users and Client Type restrictions, the value of Restrict-Logging parameter is set to 3 (1+2).
- The default value of Restrict-Logging parameter is 0.
- The Restrict-Logging parameter has an additional reserved value of 4.
To apply the AR System server logging restrictions
- In the BMC Remedy AR System Administration console, from the Server Information form, click the Log Filtering tab
Select the parameters on which you want to restrict the logging.
For example, to restrict the logging on users and client type, select the Users and Client Type check boxes.
For each parameter that you want to apply the restrictions on, type the value in the corresponding field.
To add restriction on multiple values for each parameter, add semicolon separated values. For example, for restricting the logging on two users, in the Users field, enter Allen;Mike.
The AR System server applies the logging restriction as follows:
- For multiple parameters, the AR System server performs an AND operation across parameters.
- For multiple values for each parameter that you select, the AR System server performs an OR operation across values that you enter.
For example, if you select Users and Client Type parameters, and if you specify Allen; Mike for the Users parameter and specify Mid-tier for the Client Type parameter, the AR System server logs actions only if user is Allen or Mike and only if they perform an action using the BMC Remedy Mid Tier.
- Click Apply.
The logging restrictions are applied immediately. The corresponding parameters in the ar.cfg (ar.conf) file are updated. You do not have to restart the AR System server.