Skip navigation.
Downloads | Product Documentation | Support

Administration Console Online Help

# Virtual Host --> Configuration --> Logging

Tasks Related Topics 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

## Related Topics

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

Table 371-1

Attribute Label | Description | Value Constraints
--- | --- | ---
Logging Enabled | Enables logging of HTTP requests. MBean: `weblogic.management. configuration. VirtualHostMBean` Attribute: `LoggingEnabled` | Default: true Valid values: true false Configurable: yes
Log File Name | The HTTP request log file 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 `filename` `nnnn`, where `filename` is the name configured for the log file. MBean: `weblogic.management. configuration. VirtualHostMBean` Attribute: `LogFileName` | Default: DEFAULT_LOG_FILE_NAME Configurable: 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
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 `LogFileFlushSecs` property 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 Configurable: 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 as `FileName.n` 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
Log Rotation Type | Criteria for moving old HTTP requests to a separate log file: `By Size`. When the log file reaches the size that you specify in `MaxLogFileSizeKBytes`, the server renames the file as LogFileName.n. `By Time`. At each time interval that you specify in `LogRotationPeriodMin`, the server renames the file as LogFileName.n. 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
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
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 `LogFileBufferKBytes` property, 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
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