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

<!ELEMENT Log EMPTY >

<!ATTLIST Log
   FileCount                  CDATA                    "7"
   FileMinSize                CDATA                    "500"
   FileName                   CDATA                    "weblogic.log"
   FileTimeSpan               CDATA                    "24"
   Name                       CDATA                    #REQUIRED
   Notes                      CDATA                    #IMPLIED
   NumberOfFilesLimited       (true | false)           "false"
   RotationTime               CDATA                    "00:00"
   RotationType               (bySize | byTime | 
                               none)                   "none"
>

Parent Elements

The Log element can be a child of these elements:

• Domain
• Server

Attributes

Table 48-1 LogMBean Element Attributes

Attribute	Description	Range of Values and Default	Console Label
File-Count	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.	Default: 7	File Count
File-Min-Size	The maximum size (in kilobytes) of the log file. After the log file reaches this size, the server renames it as FileName.n.	Default: 500 Minimum: 1 Maximum: 65535 Units: kilobytes	File Min Size
File-Name	The name of the file that stores current log messages. If the pathname is not absolute, the path is assumed to be relative to the root directory of the machine on which the server is running. If the name does not include a path element, then pathname will be computed as follows: For a server log file, ./SERVER_NAME For a domain log file, ./ If neither file name nor pathname is specified, then the name is computed as follows: For a server log file, ./SERVER_NAME/SERVER_NAME.log For a domain log file, ./DOMAIN_NAME.log If you enable the server to rotate messages across multiple files, this value is the base name for the files that store old messages: FileNamen.	Default: "weblogic.log"	File Name
File-Time-Span	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.	Default: 24 Minimum: 1 Units: hours	File Time Span
Name	The name of this configuration. WebLogic Server uses an MBean to implement and persist the configuration.		Name
Notes	Optional information that you can include to describe this configuration.		Notes
Number-Of-Files-Limited	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 overwrites the oldest file. 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.	Default: false	Number Of Files Limited
Rotation-Time	Determines the start time for a time-based rotation sequence. At the time that this value specifies, the server renames the current log file as FileName.n. Thereafter, the server renames the log file at an interval that you specify in FileTimeSpan. You can create a recurring start time such as "every Monday at 09:00" or a non-recurring start time such as "9 January, 2002, 09:00." Use the following java.text.SimpleDateFormat format to specify a date and time: MM-dd-yyyy-k:mm:ss. For information about this format, refer to the <a href="http://java.sun.com/j2se/1.3/docs/api/index.html">J2EE Javadoc</a>. If the date that you specify has already past, then the day in week (E), hour in day (H), minute in hour (m) and second in minute (s) are used with the current date to recalculate a start time.	Default: 00:00	Rotation Time
Rotation-Type	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.	Default: "none" Valid values: "bySize" "byTime" "none"	Rotation Type