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 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.

Note

The video is recorded using the earlier version of AR System and is valid for AR System 9.1 and later versions.



icon-play.pngServer logging restrictions feature 

The following table lists the restrictions that you can apply to AR System server logging:

Note

 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:

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).

Notes

  • 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

  1. In the AR System Administration console, from the Server Information form, click the Log Filtering tab
    log-filter.jpg
  2. 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.

    Note

    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 Mid Tier.

  3. 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.

Related topic

ar-cfg-or-ar-conf-options-N-R

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*