WebLogic Server Configuration Reference

 Previous Next Contents Index View as PDF  

Log

 


Description

Configures the location, file-rotation criteria, and number of files that a WebLogic Server uses to store log messages. The methods in this class configure both server and domain log files.

 


Syntax

<Log
FileCount="number"
FileMinSize="number of kilobytes"
FileName="String"
FileTimeSpan="number of hours"
Name="String"
Notes="String"
NumberOfFilesLimited=( "true" | "false" )
RotationTime="String"
RotationType=( "bySize" | "byTime" | "none" )
/>

 


Parent Elements

 


Attributes

Table 40-1 Log attributes

Attribute

Description

Range of Values and Default

FileCount

The maximum number of log files that the server creates when it rotates the log. Only valid if isNumberOfFilesLimited is true and setRotationType is either Size or Time.

Admin Console field label: File Count

Required: no

Default: 7

FileMinSize

The size (1 - 65535 kilobytes) that triggers the server to move log messages to a separate file. After the log file reaches the specified minimum size, the next time the server checks the file size, it will rename the current log file as FileName.n and create a new one to store subsequent messages. (This field is relevant only if you set Rotation Type to By Size.)

Admin Console field label: File Min Size

Required: no

Units: kilobytes

Default: 500

Minimum: 1

Maximum: 65535

FileName

The name of the file that stores current log messages. A relative pathname is relative to the server's root directory.

Admin Console field label: File Name

Required: no

Default: weblogic.log

FileTimeSpan

The interval (in hours) at which the server saves old log messages to another file. This value is relevant only you use the time-based rotation type.

Admin Console field label: File Time Span

Required: no

Units: hours

Default: 24

Minimum: 1

Name

The name of this configuration. WebLogic Server uses an MBean to implement and persist the configuration.

Required: no

Notes

Optional information that you can include to describe this configuration.

Required: no

NumberOfFilesLimited

Limits the number of files that a server creates to store old messages to the maximum number specified in FileCount. After the server reaches this limit, it deletes the oldest log file and creates a new log file with the latest suffix.

If you do not enable this option, the server creates new files indefinitely. You must clean up these files as you require.

This value is relevant only if you specify a file rotation type of SIZE or TIME.

Admin Console field label: Number Of Files Limited

Required: no

Default: false

Secure value: false

RotationTime

Determines the start time for a time-based rotation sequence.

Admin Console field label: Rotation Time

Required: no

Default: 00:00

RotationType

Criteria for moving old log messages to a separate file:

  • NONE . Messages accumulate in a single file. You must erase the contents of the file when the size is unwieldy.

  • SIZE . When the log file reaches the size that you specify in FileMinSize, the server renames the file as FileName.n.

  • TIME . At each time interval that you specify in TimeSpan, the server renames the file as FileName.n.

After the server renames a file, subsequent messages accumulate in a new file with the name that you specified in FileName.

Admin Console field label: Rotation Type

Required: no

Default: none

 

Back to Top Previous Next