Log Files

Contents / Administrator Docs / Developer Docs / Index / AdminTool Contents

This document has the following sections:

Settings
Buttons

The Log Files page allows you to define the settings for five types of log files. These are:

Access Log - contains a log of all incoming requests and lets you track and get information about clients of the server, such as date, remote user, remote host, and description string.
Agent Log - lists the user-agent headers used to determine the browser type making a request.
Error Log - lists internal server errors and is useful for troubleshooting.
Event Log - lists server tracing events (for example, a startup or shutdown) and servlet log information (by default).
Referer Log - lists the referer header, and the name of the file it requests. The referer header document holds the link that points to the requested document page.

Settings

Although there are five different logs, each with its own purpose, the fields for each log are the same. These are:

Log Name
The name of one of the five logs.

Description
A brief description of the log and what it does. You can change this description by deleting the text and typing in new text.

Which Messages
Gives you the choice of which messages to log. Different logs have different choices. These are:

access_log
- None
- All
agent_log
- None
- All
error_log
- None
- Major Problems
- Major and Minor Problems
- All Problems
event_log
- None
- Start/Stop Events
- Detailed Events
- All Events
referer_log
- None
- All

Log To
The Log To field allows you to choose how you want to store or display the log information. You have five choices:

Rolling File - A rolling file collects log data until it reaches the size set in the Rollover File Size setting. When the size is reached the Java^TM Web Server^TM starts a new file and "rolls over," or continues writing data, to the new file. The previous file is renamed filename.1, getting sequentially older backwards to filename.9. This makes it easy to remove the old logs without affecting the running service.
Single File - A file that collects log data until it reaches the maximum size allowed. This size is variable, and can be defined by the disk space allotted to the log directory. When it reaches the maximum size, it goes back to the beginning of the file and overwrites the previous entries.
Standard Output - In most cases, the terminal screen of the machine running the Java Web Server.
Error Output - The default error log for the system running the Java Server.

File Name
Each log has its own log filename, and each service has its own directory for storing its logs. The service log directories are all stored in the directory server_root/logs.

The names of the log files are:

Access Log - access_log
Agent log - agent_log
Error Log - error_log
Event Log - event_log
Referer Log - referer_log

The service log directories are:

Web Service - server_root/logs/javawebserver/webpageservice/log_name
Proxy Service - server_root/logs/javawebserver/proxyservice/log_name
Secure Web Service - server_root/logs/javawebserver/secureservice/log_name

Rollover File Size
The size limit on a rollover log file. When it reaches the size defined in this parameter, the Java Web Server creates a new log file, and "rolls" the data over into the new file. The default is 1 Megabyte (1000 KB). Maximum size is 10 Megabytes (10000 KB).

Buffer Size
This determines how much data is stored in memory before being sent to the log file on disk. The default is 8 Kilobytes.

Buttons

To make changes to the Log Files page and have those settings take affect, choose one of the buttons at the bottom of the screen. These are:

Save - Writes your changes to the Java Web Server and changes the settings.
Revert - Takes you back to the previous settings for all fields in the screen. Use this button to undo changes you have not yet saved.
Defaults - Displays the settings that were active when you entered the Log Files page.

Top

java-server-feedback@java.sun.com