|
•
|
The Logs tab
|
|
•
|
The accurev.log log file
|
This section describes logging features in the AccuRev GUI and how to use them. Logging is also available for the AccuRev Server. See Server Logging on page 18 in the AccuRev Administrator’s Guide for more information.
Note: Logging in the Logs tab and in the accurev.log are independent. Settings for the accurev.log file have no effect on the information displayed on the Logs tab, for example.
|
•
|
Update and Update Preview
|
|
•
|
|
•
|
commands that change include/exclude rules
|
|
•
|
Operation - The command that created the log: Update, Update Preview, Populate, Include, Exclude, Clear.
|
|
•
|
Stream - The workspace or stream in which the operation took place.
|
|
•
|
Date - A timestamp indicating when the operation took place.
|
|
•
|
View - Display the contents of the selected log in a text editor window. You can use environment variable AC_EDITOR_GUI or EDITOR to control which text editor gets invoked. If neither variable is set, AccuRev selects a program provided by the operating system.
|
|
•
|
Save As - Copy the selected log to another location.
|
|
•
|
Delete - Remove the log file from disk storage (and from this table). Logs are stored in temporary files (for example, C:\Documents and Settings\jjp\Local Settings\Temp\log3382.tmp). These files are removed automatically at the end of the GUI session.
|
AccuRev records all operations performed in the AccuRev GUI in the accurev.log file on a daily basis; if you stop and start AccuRev multiple times during the same calendar day, the existing log is updated. The accurev.log file for a given day is archived upon creation of the first log message on the following day. To create the archive log file, AccuRev renames the daily log file with a yyyy-mm-dd timestamp; the archive log file for June 1, 2012 would be named accurev.2012-06-01.log, for example. The daily log file, accurev.log, is always used to record activity for the current day.
By default, AccuRev stores archive log files for 10 days; archive log files older than 10 days are deleted. Both the daily log file and archive log file are written to the \log directory where you installed the AccuRev client (c:\Program Files (x86)\AccuRev\log, for example).
Example. Imagine you started AccuRev on June 1, 2012 and used it every day for a couple of weeks. At 9 a.m. on June 2, you performed a keep of several modified files; AccuRev creates a message in the accurev.log file, and creates the archive log file for the activity for June 1 (\log\accurev.2012-06-01.log). Archive log files would be created each day in this fashion (accurev.2012-06-02.log would be created sometime on June 3, accurev.2012-06-03.log sometime on June 4, and so on). Upon the first logged event on June 12, however, two things would occur:
|
•
|
An archive log file for June 11 activity would be created (\log\accurev.2012-06-11.log) as usual.
|
|
•
|
The archive log file for June 1, 2012-06-01.log, would be deleted because it is older than 10 days.
|
You can configure the number of days you want to keep archive log files and other aspects of the log. See Configuring Logging on page 420 for more information.
To change the logging level, modify the level= attribute of the <root> element in the logback.xml file. See Configuring Logging on page 420 for more information.
The logback.xml file contains several editable settings that allow you to configure logging in the accurev.log file as summarized in the following table:
|
The default value for the level= attribute is "INFO". See Logging Levels on page 419 for more information.
|
||
|
Set the value of the level= attribute to "OFF".
|
NOTE: You should not change other values in the logback.xml file.
To change a setting in the logback.xml file:
|
1.
|
Open the logback.xml file. This file is in the \bin directory where you installed the AccuRev client.
|
|
3.
|
Save the logback.xml file.
|