Logging configuration

Configuration Variable Data Type Description
proxy.config.log2.logging_ enabled INT

Default: 1

Enables and disables event logging:

  • 0 = logging disabled
  • 1 = log errors only
  • 2 = log transactions only
  • 3 = full logging (errors + transactions) See Working With Log Files.
proxy.config.log2.max_secs_ per_buffer INT

Default: 5

Specifies the maximum amount of time before data in the buffer is flushed to disk.

proxy.config.log2.max_space_ mb_for_logs INT

Default: 5120 or 20480

The amount of space allocated to the logging directory, in megabytes.

When Content Gateway is on an appliance, the size is 5120 (5 GB) and cannot be changed.

When Content Gateway is installed on a standalone server, the default size is 20480 (20 GB) and the size is configurable.

proxy.config.log2.max_space_ mb_for_orphan_logs INT

Default: 25

The amount of space allocated to the logging directory, in megabytes, if this node is acting as a collation client.

proxy.config.log2.max_space_ mb_headroom INT

Default: 100

The tolerance for the log space limit in bytes. If the variable proxy.config.log2. auto_delete_rolled_file is set to 1 (enabled), auto-deletion of log files is triggered when the amount of free space available in the logging directory is less than the value specified here.

proxy.config.log2.hostname STRING

Default: localhost

The hostname of the machine running Content Gateway.

proxy.config.log2.logfile_dir STRING

Default: /opt/WCG/logs

The full path to the logging directory.

proxy.config.log2.logfile_perm STRING

Default: rw-r--r--

Specifies the log file permissions. The standard UNIX file permissions are used (owner, group, other). Valid values are:

  • - = no permission
  • r = read permission
  • w = write permission
  • x = execute permission Permissions are subject to the umask

settings for the Content Gateway process. This means that a umask setting of 002 will not allow write permission for others, even if specified in the configuration file.

Permissions for existing log files are not changed when the configuration is changed.

Linux only.

proxy.config.log2.custom_logs_ enabled INT

Default: 0

When enabled (1), supports the definition and generation of custom log files according to the specifications in logs_ xml.config.

See logs_xml.config.

proxy.config.log2.xml_logs_ config INT

Default: 1

Specifies the size, in MB, which when reached causes the log files to roll. See Rolling event log files.

proxy.config.log2.squid_log_ enabled INT

Default: 0

Enables (1) or disables (0) the squid log file format.

proxy.config.log2.squid_log_is_ ascii INT

Default: 1

The squid log file type:

  • 1 = ASCII
  • 0 = binary
proxy.config.log2.squid_log_ name STRING

Default: squid

Specifies the squid log filename.

proxy.config.log2.squid_log_ header STRING

Default: NULL

The squid log file header text.

proxy.config.log2.common_log_ enabled INT

Default: 0

Enables (1) or disables (0) the Netscape common log file format.

proxy.config.log2.common_log_ is_ascii INT

Default: 1

The Netscape common log file type:

  • 1 = ASCII
  • 0 = binary
proxy.config.log2.common_log_ name STRING

Default: common

The Netscape common log filename.

proxy.config.log2.common_log_ header STRING

Default: NULL

The Netscape common log file header text.

proxy.config.log2.extended_ log_enabled INT

Default: 1

Enables (1) or disables (0) the Netscape extended log file format.

proxy.confg.log2.extended_log_ is_ascii INT

Default: 1

The Netscape extended log file type:

  • 1 = ASCII
  • 0 = binary
proxy.config.log2.extended_ log_name STRING

Default: extended

Specifies the Netscape extended log filename.

proxy.config.log2.extended_ log_header STRING

Default: NULL

Specifies the Netscape extended log file header text.

proxy.config.log2.extended2_ log_enabled INT

Default: 0

Enables (1) or disables (0) the Netscape Extended-2 log file format.

proxy.config.log2.extended2_ log_is_ascii INT

Default: 1

The Netscape Extended-2 log file type:

  • 1 = ASCII
  • 0 = binary
proxy.config.log2.extended2_ log_name STRING

Default: extended2

The Netscape Extended-2 log filename.

proxy.config.log2.extended2_ log_header STRING

Default: NULL

The Netscape Extended-2 log file header text.

proxy.config.log2.separate_ host_logs INT

Default: 0

When enabled (1), configures Content Gateway to create a separate log file for HTTP/FTP transactions for each origin server listed in the log_hosts.config file (see HTTP host log splitting).

proxy.local.log2.collation_mode INT

Default: 0

The log collation mode:

  • 0 = Collation disabled.
  • 1 = This host is a log collation server.
  • 2 = This host is a collation client and sends entries using standard formats to the collation server.

For information about sending XML- based custom formats to the collation server, see logs_xml.config.

proxy.confg.log2.collation_host STRING

Default: NULL

The hostname of the log collation server.

proxy.config.log2.collation_port INT

Default: 8085

The port used for communication between the collation server and client.

proxy.config.log2.collation_ secret STRING

Default: foobar

The password used to validate logging data and prevent the exchange of unauthorized information when a collation server is being used.

proxy.config.log2.collation_ host_tagged INT

Default: 0

When enabled (1), configures Content Gateway to include the hostname of the collation client that generated the log entry in each entry.

proxy.config.log2.collation_ retry_sec INT

Default: 5

The number of seconds between collation server connection retries.

proxy.config.log2.rolling_ enabled INT

Default: 1

Enables (1) or disables (0) log file rolling. See Rolling event log files.

proxy.config.log2.rolling_ interval_sec INT

Default: 21600

The log file rolling interval, in seconds. The minimum value is 300 (5 minutes). The maximum value is 86400 seconds (one day).

proxy.config.log2.rolling_ offset_hr INT

Default: 0

The file rolling offset hour. The hour of the day that starts the log rolling period.

proxy.config.log2.rolling_size_ mb INT

Default: 10

The size, in megabytes, which when reached causes the current file to be closed and a new file to be created.

proxy.config.log2.auto_delete_ rolled_files INT

Default: 1

Enables (1) or disables (0) automatic deletion of rolled files.

proxy.config.log2.sampling_ frequency INT

Default: 1

Configures Content Gateway to log only a sample of transactions rather than every transaction. You can specify the following values:

  • 1 = log every transaction
  • 2 = log every second transaction
  • 3 = log every third transaction and so on...