Changing Log File Retention Periods

Retention periods can be configured to specify how long log information is stored. After the defined period, log files that exceed the retention period can either be moved to an archive location or be deleted automatically. File retention can also be configured based on total file size, so that the oldest files are either deleted or moved to an archive location until the total size of all log files is lower than a specified limit. The log files are checked/moved/deleted every full hour.

Open the appropriate file with a text editor, depending on the server or component for which you want to change the log file retention period:

Front-end server

SccFrontendBootConf.xml, located in the /conf/frontendserver folder of the Performance Manager directory on the front-end server.

Application server, rules and incidents

SccAppServerBootConf.xml, located in the /conf/appserver folder of the Performance Manager directory on the application server.

Execution server

SccExecServerBootConf.xml, located in the /conf/execserver folder of the Performance Manager directory on the execution server(s).

Chart server

SccChartServerBootConf.xml, located in the /conf/chartserver folder of the Performance Manager directory on the chart server(s).
Locate the Log XML tag. For the application server log file, locate the <AppLog> XML tag, and for the rules and condition log files the <RuleLog> tag.

The following general log file settings can be configured:

XML tag	Description
`<SystemLog>`	Name of the log file, for example `AppServer.log`.
`<LogPath>`	Folder path where the log files are written to. This can be a relative or absolute path.
`<LogLevel>`	Level of detail of the information that is logged. For more information, see Changing Log Levels of the Servers .
`<LogSize>`	Size in bytes after which a new log file is created. The minimum configurable size is 512000 byte. If you enter a smaller value, the value is ignored.

The following log retention settings can be configured:

XML tag	Description
`<MaxAge>`	Time in days after which log files are either moved or deleted. Enter `0` to disable this setting.
`<MaxTotalSize>`	Total size in megabytes of the log file after which the oldest files are either moved or deleted. Enter `0` to disable this setting.
`<Compress>`	`True` to compress log files before moving them to the archive, `False` to move them as they are.
`<ArchiveLocation>`	Local or remote path where archived files are to be stored. If empty, log files are being deleted instead of moved after they exceed the specified age or total size.

Save and close the XML file.

Example

  <AppLog>
    <SystemLog>AppServer.log</SystemLog>
    <LogPath>applog</LogPath>
    <LogLevel>3</LogLevel>
    <LogSize>512000</LogSize>
    <JdbcLogConf>conf/AppServer/JdbcLoggingConf.xml</JdbcLogConf>
    <Archive>
      <MaxAge>2</MaxAge>
      <MaxTotalSize>512</MaxTotalSize>
      <Compress>True</Compress>
      <ArchiveLocation>D:\temp\logArchiver\appserver\</ArchiveLocation>
    </Archive>
  </AppLog>