centralBinaryLogFile Element for log [IIS Settings Schema]

Note

For more information about the centralBinaryLogFile element, see the following topic on the Microsoft IIS.net Web site: Central Binary Log File <centralBinaryLogFile>.

Specifies the central binary log settings for all sites on a server.

Note

Central logging must be enabled and centralLogFileMode must be set to CentralBinary for these settings to work. For more information about centralLogFileMode, see log Element for system.applicationHost [IIS Settings Schema].

Syntax

Attributes and Elements

The following sections describe attributes, child elements, and parent elements for this section.

Attributes

Attribute	Description
directory	Optional string attribute. Specifies the directory where log entries are written.
enabled	Optional Boolean attribute. Specifies whether central binary logging is enabled. Additionally, centralLogFileMode must be set to CentralBinary in order to fully enable central binary logging. For more information about centralLogFileMode, see log Element for system.applicationHost [IIS Settings Schema]. The default value is false.
localTimeRollover	Optional Boolean attribute. Specifies whether a new log file is created based on local time or Coordinated Universal Time (UTC). The default value is false.
period	Optional enum attribute. Specifies how frequently the log file contents should be cleared. The period attribute can be one of the following possible values. The default value is false. Value Description MaxSize Log files are cleared whenever the log file reaches the size specified by the truncateSize attribute. The numeric value is 0. Daily Log files are cleared every day. The numeric value is 1. Weekly Log files are cleared once a week. The numeric value is 2. Monthly Log files are cleared once a month. The numeric value is 3. Hourly Log files are cleared every hour. The numeric value is 4.
truncateSize	Optional int attribute. Specifies the size at which the log file contents should be truncated. This attribute must be set when the value of the period attribute is maxSize. The size must be between 1048576 (1 megabyte) and 4294967295 (4 gigabytes). The default value is 20971520 (20 megabytes).

Child Elements

None.

Parent Elements

Element	Description
configuration	Specifies the root element in every configuration file that is used by IIS 7.
system.applicationHost	Specifies the root element for configuring Web process settings.
log	Specifies the logging mode for a server.

Remarks

For more information about the centralBinaryLogFile element, see the following topic on the Microsoft IIS.net Web site: Central Binary Log File <centralBinaryLogFile>.

Element Information

Configuration locations	Machine.config ApplicationHost.config Root application Web.config Application Web.config Directory Web.config
Requirements	Microsoft Internet Information Services (IIS) version 7.0

See Also

Reference

centralW3CLogFile Element for log [IIS Settings Schema]