Administration Console Online Help

 Previous Next Contents Index  

 


Virtual Host --> Configuration --> Logging

Tasks     Additional Documentation     Attributes

Overview

The Virtual Host—>Configuration—>Logging tab configures the logging of HTTP requests for a virtual host. If you enable HTTP logging, the virtual host saves its HTTP requests in a log file that is separate from the server's log files.

You can also use this tab to specify the longevity and format of the data in the virtual hosts's HTTP log file.

Tasks

Specifying HTTP Log File Settings for a Virtual Host

Configuring a VirtualHost

Additional Documentation

(Requires an Internet connection.)

For more information about HTTP logs, see "Setting Up HTTP Access Logs" under Configuring WebLogic Server Web Components in the Administration Guide. This topic includes information about using the extended format in HTTP logs.

For more information about VirtualHosts, please see the Administration Guide, Configuring WebLogic Server Web Components.

Attributes

Attribute Label

Description

Value Constraints

Logging Enabled

Enables logging of HTTP requests.

MBean: weblogic.management.
configuration.
VirtualHostMBean

Attribute: LoggingEnabled

Default: true

Readable: yes

Writable: yes

Log File Name

The name of the file that stores HTTP requests. 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.

This value is relevant only if HTTP logging is enabled.

To include a time or date stamp in the file name when the log file is rotated, add java.text.SimpleDateFormat variables. Surround each variable with percentage (%) characters.

For example, access_%yyyy%_%MM%_%dd%_%hh%_%mm%.log

If you do not include a time and date stamp, the rotated log files are numbered in order of creation filenamennnnn, where filename is the name configured for the log file.

MBean: weblogic.management.
configuration.
VirtualHostMBean

Attribute: LogFileName

Default: "access.log"

Configurable: yes

Readable: yes

Writable: yes

Log File Format

Specifies the format of the HTTP log file. Both formats are defined by the W3C. With the extended log format, you use server directives in the log file to customize the information that the server records.

MBean: weblogic.management.
configuration.
VirtualHostMBean

Attribute: LogFileFormat

Default: "common"

Valid values:

  • "common"

  • "extended"

Configurable: yes

Dynamic: yes

Readable: yes

Writable: yes

Log File BufferK Bytes

The maximum size (in kilobytes) of the buffer that stores HTTP requests. When the buffer reaches this size, the server writes the data to the HTTP log file. Use the LogFileFlushSecsproperty to determine the frequency with which the server checks the size of the buffer.

MBean: weblogic.management.
configuration.
VirtualHostMBean

Attribute: LogFileBufferKBytes

Units: kilobytes

Minimum: 0

Maximum: 1024

Default: 8

Readable: yes

Writable: yes

Max Log File Size KBytes

The file size (1 - 65535 kilobytes) that triggers the server to move log messages to a separate file. After the log file reaches the specified size, the next time the server checks the file size, it will rename the current log file and create a new one to store subsequent messages.

0 causes the file to grow indefinitely.

This property is relevant only if you choose to rotate files by size.

MBean: weblogic.management.
configuration.
VirtualHostMBean

Attribute: MaxLogFileSizeKBytes

Units: kilobytes

Minimum: 0

Default: 0

Configurable: yes

Readable: yes

Writable: yes

Log Rotation Type

Criteria for moving old HTTP requests to a separate log file:

  • size. When the log file reaches the size that you specify in MaxLogFileSizeKBytes, the server renames the file.

  • date. At each time interval that you specify in LogRotationPeriodMin, the server renames the file.

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

MBean: weblogic.management.
configuration.
VirtualHostMBean

Attribute: LogRotationType

Default: "size"

Valid values:

  • "size"

  • "date"

Configurable: yes

Readable: yes

Writable: yes

Log Rotation Period Mins

The interval (in minutes) at which the server saves old HTTP requests to another log file. This value is relevant only if you use the date-based rotation type.

MBean: weblogic.management.
configuration.
VirtualHostMBean

Attribute: LogRotationPeriodMins

Units: minutes

Minimum: 1

Maximum: 2147483647

Default: 1440

Configurable: yes

Readable: yes

Writable: yes

Log File Flush Secs

The interval (in seconds) at which the server checks the size of the buffer that stores HTTP requests. When the buffer exceeds the size that is specified in the LogFileBufferKBytesproperty, the server writes the data in the buffer to the HTTP request log file.

MBean: weblogic.management.
configuration.
VirtualHostMBean

Attribute: LogFileFlushSecs

Units: seconds

Minimum: 1

Maximum: 360

Default: 60

Configurable: yes

Readable: yes

Writable: yes

Log Rotation Time Begin

Determines the start time for a time-based rotation sequence. At the time that this value specifies, the server renames the current log file. Thereafter, the server renames the log file at an interval that you specify in LogRotationPeriodMins.

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 J2EE Javadoc.

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

MBean: weblogic.management.
configuration.
VirtualHostMBean

Attribute: LogRotationTimeBegin

Configurable: yes

Readable: yes

Writable: yes



 

Back to Top Previous Next