Previous Contents Index Next
Sun ONE Web Server 6.1 Administrator's Guide

> ## The Logs Tab

> The Logs Tab allows you to configure your access and error logs, view them, and archive them.

> The Logs Tab contains the following pages:

> - The View Access Log Page
> - The View Error Log Page
> - The Archive Log Files Page
> - The Access Log Preferences Page
> - The Generate Report Page

> ##

> The View Access Log Page

> If you are accessing this page from the Administration Server, see The View Access Log Page in the Administration Server section.

> If you are accessing this page from the Virtual Server Manager, see The View Access Log Page in the Virtual Server Manager section.

> The View Access Log page allows you to configure a customized view of the information about requests to the server instance and the responses from the server. You can also view logs through the Virtual Server Manager.

> For more information, see the following sections:

> - About Log Files
> - Viewing an Access Log File

> The following elements are displayed:

> Number of entries. Specifies the number of entries to retrieve (starting with the most recent).

> Only show entries with. Specifies a string or a character to filter the log entries. Case is important; the case of the string or character specified in this field must match the case of the entry in the access log. For example, if you want to see only access log entries that contain POST, type “POST.” If all the virtual servers are logged to one main log file, and you have set up the log file to log the virtual server ID, enter the virtual server ID in this field to get just the entries for a single virtual server.

> OK. Displays the log entries in the lower section of this page.

> Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

> Help. Displays online help.

> ##

> The View Error Log Page

> If you are accessing this page from the Administration Server, see The View Error Log Page in the Administration Server section.

> If you are accessing this page from the Virtual Server Manager, see The View Error Log Page in the Virtual Server Manager section.

> The View Error Log allows you to configure a customized view of the errors the server has encountered as well as the informational messages about the server, such as when the server was started and who has tried unsuccessfully to log in to the server. You can also view logs through the Virtual Server Manager.

> For more information, see the following sections:

> - About Log Files
> - Viewing the Error Log File

> The following elements are displayed:

> Number of errors to view? Specifies the number of entries to retrieve (starting with the most recent).

> Only show entries with. Specifies a string or a character to filter the log entries. Case is important; the case of the string or character specified in this field must match the case of the entry in the error log. For example, if you want to see only those error messages that contain warning, type “warning.”

> OK. Displays the log entries in the lower section of this page

> Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

> Help. Displays online help.

> ##

> The Archive Log Files Page

> The Archive Log page allows you to automatically rotate your access and error log files at regular intervals. When you archive log files, the server renames the current log files and then creates new log files with the original names. You can archive or delete the old log files, which are saved as the original file name followed by the date and time the file was archived. For example, access might become access.200307152400.

> The Archive Log File page allows you to archive your log files immediately or specify days and times when archiving will take place.

> When you archive logs, you archive all logs for all virtual servers.

> For more information, see Archiving Log Files.

> The following elements are displayed:

> Internal daemon log rotation. Specifies whether to use Sun ONE Web Server internal system daemon log settings for log rotation.

> - rotation start time. Specifies the time used as a basis to rotate log files and start a new log file. For example, if the rotation start time is 12:00 a.m., and the rotation interval is 1440 minutes (one day), a new log file will be created when you save and apply changes. The log file will rotate every day at 12:00 a.m., and the access log will be stamped at 12:00 a.m. and saved as access.200304241200. Likewise, if you set the interval at 240 minutes (4 hours), the 4 hour intervals begin at 12:00 a.m. such that the access log files will contain information gathered from 12:00 a.m. to 4:00 a.m., from 4:00 a.m. to 8:00 a.m., and so forth.
> - rotation interval (minutes). Specifies the number of minutes until the next log rotation when a new log file is started. You must specify an interval of at least 30 minutes or more.

> Cron based log rotation. Specifies whether to use the operating system’s cron (or job scheduling) facility to schedule log archiving.

> Note | Before archiving the log files, you must shut down the The Cron Control Page (UNIX/Linux) from the Administration Server.

> - Archive the log files now. Archives the log file that is currently being written to and restarts the server when you click Archive. Note that clicking “Archive the log files now” archives both the access and error logs.
> - rotate log at. Specifies the time and day of the week on which log archiving will occur. To select multiple times, hold the Control key when clicking on the time.

> OK. Saves your entries.

> Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

> Help. Displays online help.

> ##

> The Access Log Preferences Page

> The Access Log Preferences page allows you to specify what information is recorded in your server’s logs. Server log files can help you monitor your server’s activity and troubleshoot problems.

> For more information, see Setting Access Log Preferences.

> Note | You should not change the log format of a log that is already in use.

> The following elements are displayed:

> Editing. Specifies a resource to which custom logging is applied. If you choose a directory, custom logging applies only when the server receives a URL for that directory or any file in that directory. If you want to set up logging for individual virtual servers, use The Logging Settings Page in the Class Manager.

> Go. Click this button to load data.

> Browse. Allows you to browse your file system. After clicking this button, the The Choose a Part of Your Server Page page displays. Clicking the Options button on this page displays browse options. For information on the browse option, see The Browse Files On Your Server Page.

> Wildcard. Specifies a wildcard pattern. the path used must be an absolute path to the file. For information on using wildcard patterns, see Wildcards Used in the Resource Picker.

> Log client accesses? Specifies whether to include client accesses in your log files.

> Log File. Specifies the absolute path for the access log file. As a default, the log files are kept in the logs directory in the server root. If you specify a partial path, the server assumes the path is relative to the logs directory in the server root.

> If you are editing the entire server, the default value for this field is $accesslog, the variable that denotes the access log file for the server and virtual servers in the configuration file.

> Record. Specifies whether the server should record domain names or IP addresses of the systems accessing the server in the access log.

> Format. Specifies which type of log file format to use in the access log. You can select from the following:

> - Use Common Logfile Format. Includes client’s host name, authenticated user name, date and time of request, HTTP header, status code returned to the client, and content length of the document sent to the client, or
> - Only Log. Allows you to choose which information will be logged. You can choose from the following:
> - Client hostname. The hostname (or IP address if DNS is disabled) of the client requesting access.
> - Authenticate user name. If authentication was necessary, you can have the authenticated user name listed in the access log.
> - System date. The date and time of the client request.
> - Full request. The exact request the client made.
> - Status. The status code the server returned to the client.
> - Content length. The content length, in bytes, of the document sent to the client.
> - HTTP header, “referer”. The referer specifies the page from which the client accessed the current page. For example, if a user was looking at the results from a text search query, the referer would be the page from which the user accessed the text search engine. Referers allow the server to create a list of backtracked links.
> - HTTP header, “user-agent”. The user-agent information—which includes the type of browser the client is using, its version, and the operating system it’s running on—comes from the User-agent field in the HTTP header information the client sends to the server.
> - Method. The HTTP request method used (GET, PUT, POST, etc.).
> - URI. Universal Resource Identifier. The location of a resource on the server. For example, for http://www.a.com:8080/special/docs, the URI is special/docs.
> - Query string of the URI. Anything after the question mark in a URI. For example, for
>   http://www.a.com:8080/special/docs?find_this, the query string of the URI is find_this.
> - Protocol. The transport protocol and version used.
> - Virtual Server Id. The ID of the virtual server. This option is available only at the server instance and not at the Administration Server level. You do not need to include this if you are setting up separate log files for each virtual server.

> Custom Format. Allows you to create a customized format for your access log. For more information about the parameters you should use for your custom format, see Setting Access Log Preferences.

> OK. Saves your entries.

> Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

> Help. Displays online help.

> ##

> The Choose a Part of Your Server Page

> The Choose a Part of Your Server page is used to choose a particular file or a directory on which you want to configure remote file manipulation.

> After you choose either a directory or a file, this page will lead back to The Remote File Manipulation Page to proceed with rest of the configuration for remote file manipulation. The following elements are displayed:

> Back. Click the Back button to return to the previous page.

> choose entire directory: Click the choose entire directory link to display the File Manipulation page, used to allow clients to perform remote file manipulation tasks on your server. For more information about performing remote file manipulation tasks, see The Remote File Manipulation Page.

> Options. Click the Options button to display the Browse Files On Your Server page where you choose browsing options.For information on the browse option, see The Browse Files On Your Server Page.

> Help. Displays online help.

> ##

> The Browse Files On Your Server Page

> The Browse Files On Your Server page allows you to browse the files on your server. The following elements are displayed:

> Back. Click this button to return to the previous page.

> List from. Specify the path for the directory you want to browse, and then choose from the following options:

> - Only list directories
> - List files as well as directories
> - Follow sym-links
> - Do not follow sym-links

> OK. Click OK to display results.

> Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

> Help. Displays online help.

> ##

> The Error Log Preferences Page

> The Error Log Preferences page allows you to configure what information is recorded in your server’s error logs. Server error log files can help you monitor your server’s activity and troubleshoot problems.

> For more information, see Setting Access Log Preferences.

> The following elements are displayed:

> Error Log File Name. Specifies the file that stores messages from the server

> Log Level. Specifies the amount of information that can be logged in the errors log. The options are:

> - finest: indicates a highly detailed tracing message.
> - finer: indicates a fairly detailed tracing message.
> - fine: a message level providing tracing information.
> - info: a message level for informational messages.
> - warning: a message level indicating a potential problem.
> - failure: a message level indicating a failure
> - config: message level for static configuration messages.
> - security: a message level for a security issue.
> - catastrophe: a message level indicating a serious failure.

> Log VSID. Check this if you want virtual server IDs to be displayed in the virtual server logs. This is useful if multiple VS elements share the same log file.

> LogStdout. Check this if you want stdout output to be redirected to the errors log.

> Log Stderr. Check this if you want stderr output to be redirected to the errors log.

> Log To Console (UNIX only). Check this to redirect log messages to the console.

> Use System Logging. Check this if you want to use the UNIX syslog service or Windows Event Logging to produce and manage logs.

> Create Console (Windows Only). Check this to create a Windows console for stderr output.

> OK. Saves your entries.

> Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

> Help. Displays online help.

> ##

> The Generate Report Page

> The Generate Report page allows you to generate a report about a server’s activity using the log analyzer. Use the log analyzer to generate statistics about your server, such as a summary of activity, most commonly accessed URLs, times during the day when the server is accessed most frequently, and so on. You can also run the log analyzer from the Server Manager or the command line.

> Note | Before running the log analyzer, you should archive the server logs. For more information about archiving server logs, see Archiving Log Files.

> For more information, see Running the Log Analyzer.

> The following elements are displayed:

> Server name. Specifies the name of the server for which to generate the report.

> Output type. Specifies whether the report should be output to an HTML file or to a plain text (ASCII) file.

> Log File. Specifies the log file or files to generate the report from. To select more than one file, hold the Control key when clicking on the file.

> Output file. Specifies the absolute path to where the report should go. If you leave this field blank, the analyzer displays the results on the screen. For large log files, you should save the results to a file because displaying the output on the screen may take a long time.

> Totals. Specifies whether you want to generate totals for statistics. Choose “Do not generate totals” if you do not want to generate totals for statistics. If you choose to generate totals, specify the items from the following list for which you would like to generate totals:

> - Total hits. Number of requests the server received since access logging was enabled.
> - 304 (Not Modified) status codes. Number of times the requesting client used a local copy of the requested document, rather than retrieving it from the server.
> - 302 (Redirects) status codes. Number of times the server redirected to a new URL because the original URL moved.
> - 404 (Not Found) status codes. Number of times the server could not find the requested document or the server did not serve the document because the client was not an authorized user.
> - 500 (Server Error) status codes. Number of times server-related error occurred.
> - Total unique URLs. Number of unique URLs accessed since access logging was enabled.
> - Total unique hosts. Number of unique client hosts who have accessed the server since access logging was enabled.
> - Total kilobytes transferred. Number of kilobytes the server transferred since access logging was enabled.

> General Statistics. Specifies whether to generate general statistics. Choose “Do not generate general statistics” if you do not want to generate general statistics. If you choose to generate statistics, choose from the following:

> - Find top number seconds of log. Generates statistics based on information from the most recent number of seconds.
> - Find top number minutes of log. Generates statistics based on information from the most recent number of minutes.
> - Find top number hours of log. Generates statistics based on information from the most recent number of hours.
> - Find number users (if logged). Generates statistics based on information from the number of users.
> - Find top number referers (if logged). Generates statistics based on information from the number of referers.
> - Find top number user agents (if logged). Generates statistics based on information on the user agents, for example, the browser type, its version, and the operating system.
> - Find top number miscellaneous logged items (if logged). Generates statistics based on information from the number of user.

> Generate Lists. Specifies whether to generate lists. Choose Do not generate any list if you do not want to generate any lists. If you choose to generate lists, specify the items from the following list for which you would like to generate lists:

> - number most commonly accessed URL. Displays the most commonly accessed URLs or URLs that were accessed more than a specified number of times.
> - URLs that were accessed more than number times. Displays the URL that were accessed more times than the number specified.
> - number hosts most often accessing your server. Displays the hosts most often accessing your server or hosts that have accessed your server more than a specified number of times
> - Hosts that accessed your server more than number times. Displays the hosts that accessed your server more times than the number specified.

> Output Order. Specifies the order of the output. Prioritize the following items from 1 to 3 in the order that you would like each section to appear in the report. If you chose to not generate any of them, the section will automatically be left out.

> OK. Saves your entries.

> Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

> Help. Displays online help.

> Previous Contents Index Next

> Copyright 2004 Sun Microsystems, Inc. All rights reserved.