Log Configuration (Beta)
Contents / Settings /
Buttons
The Log Configuration 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
- error_log
- None
- Major Problems
- Major and Minor Problems
- All Problems
- event_log
- None
- Start/Stop Events
- Detailed Events
- All Events
- agent_log
- referer_log
Log To
The Log To field allows you to choose how you want to store or display the log
information. You have six 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
Server 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.
- Socket - Allows a system administrator to direct log data to a
socket which can interface with a specially-written script or program that
processes the data. The default Socket Host is
localhost
and the
default Socket Port is 777
.
- Standard Output - In most cases, the terminal screen of the machine
running the Java Server.
- Error Output - The default error log for the system running the Java
Server.
- Special Class File - Allows an advanced user to direct log data at
a specially-written Java class file that can then do further processng on the
data.
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 Page Service - server_root
/logs/WebPageService/
log_name
- Proxy Service - server_root
/logs/ProxyService/
log_name
- Secure Web Service - server_root
/logs/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 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 Configuration page and have those settings
take affect, use the two buttons at the bottom of the screen. These
are:
- Save - Writes your changes to the Java 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.
Top
java-server-feedback@java.sun.com