Administration Tool: Log Files

Panel Description

Documentation Contents

/ Documentation Index

/ Glossary

/ Administration Tool Help

Purpose

The Log Files panel enables you to select which types of log files you would like to keep and to define their settings. Log files are used to store information about the general operation of Java Web Server, including its servicing of client requests. These files can be useful for monitoring and analysis purposes.

The Log Outputs panel enables you to view the entries made in the logs you have selected. For more information on viewing log entries, see the Log Outputs online help document.

The Log Statistics panel enables you to sort and display the log file entries as various charts or tables. For more information on the presentation of log entries for analysis, see the Log Statistics online help document.

By default, the following log types are defined for the Java Web Server:

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.
Combined Log - Same as the Access Log, but with agent and referer information appended.
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.

Location of panel in Administration Tool:

Log In	-->		Service name	-->	Manage	-->	Setup
							\|_ Logs

Fields

Log Name
The name of the log file.

Description
A brief description of the log and what it does.

Log Virtual Host Name
When enabled, adds the virtual host name to the end of the log message. This option is only applicable for access, agent, combined, and referer logs.

Which Messages
Gives you the choice of which messages to log for that service:

Access, agent, combined, and referer logs
- None
- All
Error log
- None
- Major problems only
- All problems
- All problems, with messages
Event log
- None
- Start or stop events only
- All events
- All events, with detailed messages

Log To
Determines how to store or display the log information. There are five choices:

Rolling File - Rolling files enable you to remove the old logs without affecting the running service. A rolling file collects log data until it reaches the size set in the Rollover File Size setting. The first time that size is reached, the current file is renamed to filename.1 and a new file is created. Up to 10 rolling log files can be created in this manner (filename.1 through filename.9, plus the current filename). When that maximum number is reached, the process begins over again by renaming the current file to filename.1.
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 the file reaches the maximum size, new entries are logged at the beginning of the file and overwrite previous entries.
Standard Output - In most cases, the terminal screen of the machine running Java Web Server.
Standard Error - The default error log for the system running Java Web Server.

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

server_root/logs/

where server_root is the directory in which you installed Java Web Server.

The names of the log files are:

Access Log - access_log
Agent log - agent_log
Combined log - combined_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


   
      Secure Web Service - server_root/logs/javawebserver/secureservice/log_name
      
    
    where server_rootis the directory in which you 
    installed Java Web Server.


  Rollover File Size

    The size limit on a rollover log file. When the log file reaches the size 
    defined in this parameter, Java Web Server creates a new log file, and 
    rolls the data over into the new file. The default is 1 Megabyte (1,000 
    KBytes). Maximum size is 10 Megabytes (10,000 KBytes).

      
  Buffer Size

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

      
    
  Buttons
  Save

    Writes your changes to Java Web Server and changes the settings.

     
  Revert

    Restores 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



Copyright © 1999
Sun Microsystems, Inc.

All Rights Reserved.