Host Integrator Server Logging Options

Host Integrator can log server errors and can issue warnings and informational messages as it runs. In the Logging Options panel, you can configure the Host Integrator logging feature.

To view the Host Integrator log for the currently selected server, click View Log above the navigation tree. The log information is displayed in the Host Integrator Log Viewer.

To configure Logging Options for a Host Integrator Server:

  1. Log on to the Administrative WebStation using an Administrator profile and switch to configure mode.

  2. In the navigation tree under the name of the Host Integrator Server you want to configure, click Logging Options. The Logging Options panel is displayed.

  3. Configure the options in this panel, and then click Submit or Save. Logging options are described next.

About Logging Options

The options in this panel specify the type of logging that is performed, the location of log files, and time and space limits for log files.

Default Logging Level

The Default Logging Level item specifies which events are inserted into the log files by default. These messages are also sent to the operating system log if system logging is enabled (see below). This is a server wide setting. Client applications also have the ability to increase the logging level for their own private sessions. To record all server activity, select Log All Messages. This will include in the log all informational messages, warnings, and errors. Because this setting requires the server to track all activity, expect additional resource consumption on the server.

You may optionally select a reduced logging level for improved performance on heavily loaded servers.

Log Directory

The Log Directory option specifies the directory in which log messages stored, which by default is <installation directory>\VHI\etc\logs\server (Windows) or <installation directory>/vhi/etc/logs/server (UNIX). Using this setting an administrator can specify a different local directory where new messages will be stored. The directory you specify must already exist. Any existing messages are transferred to the newly specified location.

System Logging

When System Logging is enabled, Host Integrator sends logging messages to both the Host Integrator log files and the operating system log, which is the Event Log on Windows systems and the syslog daemon on UNIX systems. Host Integrator will also send a message to the System Log when it detects a logging system failure, regardless of this setting.

Note: Host Integrator does not manage the size of the operating system log. When System Logging is enabled, you must take steps to limit the size of your system log.

Failed Request Information Logging

The Failed Request Information Logging option helps you troubleshoot client application problems.

When Failed Request Information Logging is enabled and the server encounters an error, the server will write all activity for the failed request to the log file. This information will appear immediately before the error message in the log file. Because Failed Request Information Logging requires the server to track additional activity, enabling it will consume additional resources on the server.

Failed Request Information Logging does not have to be enabled for request failures to be recorded; enabling this setting simply appends all activity associated with the failure in addition to the failure itself. When Failed Request Information Logging is disabled, the error itself is still logged.

Note: If Logging Level is set to Log All Messages, all activity is written to the log file even when no errors are encountered and regardless of the Failed Request Information Logging setting.

Log Space Threshold Settings

The Log Space Threshold is the total amount of disk space in MB that can be used to store log records. The default is 100 MB and the range of values is 1 - 100000 MB. When the Delete logs when disk space exceeds threshold check box is selected, the oldest log entries will be deleted when the amount of disk space used by the log records exceeds the threshold. The oldest messages are deleted until space utilization is decreased to 80% of the configured maximum limit.

In addition to the space required to store messages, the logging system requires administrative storage space. For proper function of the logging system, ensure that the actual free disk space in the configured logging directory is at least twice the value of the Log Space Threshold setting.

Note: The space and time thresholds can be enabled at the same time. In this case, the most restrictive setting is used.

Log Time Threshold Settings

The Log Time Threshold is the expiration date for all log records. The default is 30 days, and the range of values is 1 - 100000 days. When the Delete logs older than threshold check box is selected, messages older than the specified threshold will be purged.

Note: The space and time thresholds can be enabled at the same time. In this case, the most restrictive setting is used.