HPEL log configuration settings

Use this page to configure High Performance Extensible Logging (HPEL) log settings.

Supported configurations: You can only access this page when the server is configured to use HPEL log and trace mode.

To view this administrative console page, click Troubleshooting > Logs and trace > server_name > Configure HPEL logging .

Directory path

Specifies the directory to which log files are written. A subdirectory, logdata, is created in this directory, and the log files are written to this location.

Avoid trouble: This path cannot be shared between servers. The server creates a file with a .owner extension to help detect when two or more servers happen to be trying to use the same path for HPEL output.

Enable log record buffering

Specifies that the logging system avoids writing to disk each time a log record is created. The logging system creates a buffer that can hold a number of log records, and writes the buffered events when the buffer is full. The logging system also writes the buffered events after a few seconds have passed, even if the buffer is not full.

Selecting this setting significantly improves logging performance; however, if the server stops unexpectedly, the contents might not be written to the log repository.

Best practice: Enable log record buffering in almost all cases. Only disable log record buffering when your server is failing unexpectedly and cannot write buffered content to disk before stopping.

Start new log file daily at <time>

Enables the logging framework to close the log file and start a new file at the specified time of day. Closing the file makes it easy to copy the file to an archive.

Best practice: If you want to automatically archive your log files, set up your backup program to copy files after the time you configured for new logs to be started. Configure the backup to occur at least 10 minutes after the time configured for new logs to be started to ensure that the server has closed the previous file.

Begin cleanup of oldest records

Specifies the log cleanup settings to be used to automatically purge the oldest log records, or log records that no longer fit in the configured space, from the log repository.

Select When log size approaches maximum to configure automatic log file cleanup to begin when the total size of the log repository approaches the configured maximum size.

Select When oldest records reach age limit to configure automatic log file cleanup to begin when log content is the age limit specified.

Select When either age or size restriction is met to configure automatic log file cleanup to begin when either of the previous conditions is met.

Regardless of the selection chosen, records are deleted from the log repository in the order in which they were written to the log repository.

Log record age limit

Specifies the lifespan, in hours, that log records can remain in the log repository before the log records can be automatically deleted by the server. When the oldest records in the log repository have existed longer than the age limit specified, then those records are targeted for deletion by the server.

Maximum log size

Specifies the maximum total size, in megabytes, that the server allows the log repository to reach. When the log repository approaches this size limit, the server deletes the oldest records from the log repository to make space for new log records.

Out of space action

Specifies how the server reacts to an inability to add content to the log repository.

Select Stop server to specify that the server stops when the server is unable to write to the log repository.

Select Purge old records to specify that the server continues to run, and that the oldest log records are immediately removed when the server is unable to write to the log repository.

Select Stop logging to specify that the server continues to run, but that the server cannot continue to write to the log when the server is unable to write to the log repository.

Save runtime changes to configuration as well

Specifies that changes are made to both the dynamic state of the running server, and the server configuration, which takes effect on the next restart. If this check box is not selected, the server does not copy the settings into the server configuration.