bea.com | products | dev2dev | support | askBEA
 Download Docs   Site Map   Glossary 
Search

Administration Console Online Help

 Previous Next Contents Index  

 


Domain --> Configuration --> Logging

Tasks     Related Topics     Attributes

Overview

The Domain—>Configuration—>Logging tab configures the location, file-rotation criteria, and number of files that the Administration Server uses to store domain log messages.

The domain's log contains messages that individual servers within the domain have forwarded. By default, only the log messages of an ERROR or higher severity are forwarded from the local servers to the domain log. To change the default, you must create a domain log filter.

Tasks

Viewing the Domain Log

Rotating Log Files

Specifying the Messages that a Server Forwards to the Domain Log

Viewing Server Logs

Related Topics

Overview of WebLogic Server Log Messages and Log Files

Attributes

Table 5-7

Attribute Label

Description

Value Constraints

File Name

The name of the file that stores current log messages for the domain log. If the pathname is not absolute, the path is assumed to be relative to the domain directory.

If the name does not include a path element, then pathname will be ./

If neither file name nor pathname is specified, then the name is ./DOMAIN_NAME.log

If you enable the domain to rotate messages across multiple files, this value is the base name for the files that store old messages: FileName.n.

MBean: weblogic.management.
configuration.LogMBean

Attribute: FileName

Default: weblogic.log

Configurable: yes

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.

MBean: weblogic.management.
configuration.LogMBean

Attribute: RotationType

Default: none

Valid values:

  • bySize

  • byTime

  • none

Dynamic: yes

Minimum File Size

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

MBean: weblogic.management.
configuration.LogMBean

Attribute: FileMinSize

Units: kilobytes

Minimum: 1

Maximum: 65535

Default: 500

Configurable: yes

Dynamic: yes

Rotation Time

Determines the start time (hour and minute) 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.

Use the following format: hh:mm, where hh is the hour in a 24-hour format and mm is the minute.

If the time that you specify has already past, then the server starts its file rotation immediately.

MBean: weblogic.management.
configuration.LogMBean

Attribute: RotationTime

Default: 00:00

Configurable: yes

Dynamic: yes

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.

MBean: weblogic.management.
configuration.LogMBean

Attribute: FileTimeSpan

Units: hours

Minimum: 1

Default: 24

Dynamic: yes

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.

MBean: weblogic.management.
configuration.LogMBean

Attribute: NumberOfFilesLimited

Default: false

Valid values:

  • true

  • false

Dynamic: yes

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.

MBean: weblogic.management.
configuration.LogMBean

Attribute: FileCount

Default: 7

Dynamic: yes

Advanced Attributes

Table 5-8

Attribute Label

Description

Value Constraints

Enable auditing of Administration Changes

Specifies whether the Administration Server generates a log message when the domain's configuration has been modified. Any change to a server, module, or other item in the domain (either through the Administration Console, command-line utilities, or the APIs) will cause the Administration Server to generate a message of INFO severity level.

Default: false

Valid values:

  • true

  • false

 

Back to Top Previous Next