httpd.servlet.logs(4)

NAME | DESCRIPTION | EXAMPLES | ATTRIBUTES | SEE ALSO

NAME

httpd.servlet.logs & httpd.cgi.logs- The log files for servlet requests and CGI script errors.

DESCRIPTION

The httpd.servlet.logs log errors are generated by servlets. You can specify the location of the log files with htservlet or through the Sun^TM WebServer^TM Administration Console. See htservlet(1m) for details on configuring log settings.

The httpd.cgi.logs log errors are generated by cgi scripts. You can specify the location of the log files through the Sun WebServer Administration Console.

Log files will be named prefix.sequence, where sequence is a cycling number. Each entry is a Common Log File (CLF) format header indicating the request that launched the servlet or CGI, followed by all error messages generated during the request.

The servlet error logs will have the following format:

{client_name  [DD/Mon/YYYY:hh:mm:ss] "request" "vhostname" "script_file_name"} 
error_messages

where error_messages is the error output for the servlet.

The CGI error logs will have the following format:

{client_name  [DD/Mon/YYYY:hh:mm:ss] "request" "vhostname" "script_file_name" [block_number]} 
error_messages

where error_messages is the error output for the CGI script, and block_number identifies the block number of the CGI script. The final block from a script also has a keyword "FINAL" at the end of the header. Since Sun WebServer uses constant buffer sizes and many CGI scripts are using the same error log file, it is impossible that error messages from a given script are logged into more than one of the above blocks. If Sun WebServer could log all the error messages from the script into just one block, then it doesn't print either the block number of the keyword "FINAL".

The most recent log file can be accessed through the log prefix. If the prefix is /var/http/default_log, then apart from having log files with names /var/http/default_log.1, you will also have a symbolic link called /var/http/default_log, which points to the latest log file that the server is writing.

See httpd.request.logs(4) for a description of the CLF.

EXAMPLES

---

Example 1




Sample CGI error logs:

{129.146.115.80 [14/Mar/1998:11:03:23 -0800] "GET /cgi-bin/login HTTP/1.0" www.A.com /tmp/tp/root1/cgi-bin/login}
Invalid number of parameters

{129.146.115.80 [14/Mar/1998:12:03:29 -0800] "GET /cgi-bin/sendfile HTTP/1.0" www.A.com /tmp/tp/root1/cgi-bin/sendfile 1}
Unable to open file:
    /var/http/server/websites/public/profiles/file.1

Output not generated.

{129.146.115.80 [14/Mar/1998:13:03:35 -0800] "GET /cgi-bin/login HTTP/1.0" www.A.com /tmp/tp/root1/cgi-bin/login 2}
Authentication failed for user "user1"

---

---

Example 2




Sample servlet error logs:

{129.146.114.181 [19/May/1998:10:21:21 -0700] "GET /servlets/network HTTP/1.0" www.A.com /servlets/network}
cannot open url connection: connect

{129.146.114.181 [19/May/1998:10:21:21 -0700] "GET /servlets/network HTTP/1.0" www.A.com /servlets/network 2 FINAL}
 
java.lang.NullPointerException
	at com.sun.sws.se.ServletEngine.newServlet(Compiled Code)
	at com.sun.sws.se.ServletEngine.loadLocalServlet(Compiled Code)
	at com.sun.sws.se.ServletEngine.loadServlet(Compiled Code)
	at com.sun.sws.se.ServletEngine.loadAndInitServlet(Compiled Code)

---

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWhttp
Interface Stability	Evolving

SEE ALSO

httpd.conf(4), httpd.site.conf(4), httpd.request.logs(4)

Sun WebServer 2.0  Last Revised 17 July 1998

NAME | DESCRIPTION | EXAMPLES | ATTRIBUTES | SEE ALSO