Sun Java System Web Proxy Server 4.0.4 管理指南

设置服务器实例的访问日志首选项

下表中列出了可用于设置服务器实例的访问日志首选项的灵活日志格式。

表 9–3 服务器实例的日志文件格式


日志格式项	描述
Client Hostname	请求访问的客户机的主机名或 IP 地址（如果已禁用 DNS）。
Authenticate User Name	如果需要进行验证，您可以在访问日志中列出经过验证的用户名。
System Date	客户机请求的日期和时间。
Full Request	客户机所作的完整请求。
Status	服务器返回给客户机的状态码。
Content Length	发送至客户机的文档的内容长度（以字节为单位）。
HTTP Header, "referer"	referer（引用站点）可以指定客户机从中访问当前页面的页面。例如，如果用户要查看文本搜索查询的结果，引用站点将是用户从中访问文本搜索引擎的页面。引用站点使服务器可创建回溯链接的列表。
HTTP Header, "user-agent"	user-agent 信息包括客户机正在使用的浏览器的类型、浏览器版本，以及正在运行的操作系统。这些信息来自客户机发送到服务器的 HTTP 标头信息的 User-agent 字段。
Method	使用的 HTTP 请求方法，如 GET、PUT 或 POST。
URI	Universal Resource Identifier（统一资源标识符）。服务器上资源的位置。例如，对于 `http://www.a.com:8080/special/docs`, URI 为 `special/docs`。
Query String Of The URI	URI 中问号之后的任何文本。例如，对于 `http://www.a.com:8080/special/docs?find_this`，URI 的查询字符串为 `find_this`。
Protocol	使用的传输协议和版本。
Cache Finish Status	此字段指定高速缓存文件是被写入、刷新还是由最新版本检查返回。
Remote Server Finish Status	此字段指定向远程服务器提交的请求是已成功执行完成，单击浏览器中的“停止”按钮时由客户机中断，还是由错误条件终止。
Status Code From Server	从服务器返回的状态码。
Route To Proxy (PROXY, SOCKS, DIRECT)	用于检索资源的路由。可以直接检索文档，也可以通过代理或 SOCKS 服务器检索文档。
Transfer Time	传送的时间长度（以秒或毫秒为单位）
Header-length From Server Response	服务器响应的标头的长度。
Request Header Size From Proxy To Server	从代理到服务器的请求标头的大小。
Response Header Size Sent To Client	发送到客户机的响应标头的大小。
Request Header Size Received From Client	从客户机接收的请求标头的大小。
Content-length From Proxy To Server Request	从代理发送到服务器的文档的长度（以字节为单位）。
Content-length Received From Client	来自客户机的文档的长度（以字节为单位）。
Content-length From Server Response	来自服务器的文档的长度（以字节为单位）。
Unverified User From Client	验证期间提供给远程服务器的用户名。

设置服务器实例的访问日志首选项

访问 Server Manager 并单击 "Server Status" 选项卡。

单击 "Set Access Log Preferences" 链接。

此时将显示 "Set Access Log Preferences" 页面。

选择下拉式列表中的资源，或者单击 "Edit" 按钮，键入一个正则表达式，然后单击 "OK"。

指定是否记录客户机类。

此设置要求启用域名服务 (Domain Name Service, DNS)。

指定访问日志文件的绝对路径。

默认情况下，日志文件存储在服务器根目录下的 logs 目录中。如果指定了部分路径，服务器将假设路径相对于服务器根目录下的 logs 目录。

如果编辑的是整个服务器，此字段的默认值为 $accesslog，它是配置文件中表示服务器的访问日志文件的变量。

选择是否应在访问日志中记录访问服务器的系统的域名或 IP 地址。

选择日志文件的格式：通用、扩展、扩展 2、仅限指定信息（"Only log" 单选按钮）或自定义。

如果单击 "Only log"，将可以使用以下灵活日志格式项：

选择要在访问日志中使用的日志文件格式的类型。

服务器访问日志格式可以为通用日志文件格式、扩展日志文件格式、扩展 2 日志文件格式、灵活日志格式或单独的可自定义格式。通用日志文件格式是普遍受支持的格式，可提供服务器的固定信息。灵活日志格式使您可以从 Proxy Server 选择要记录的内容。可自定义的格式使用参数块，用户可以指定这些参数块来控制记录的内容。
- Use Common LogFile Format。包括客户机的主机名、经过验证的用户名、请求的日期和时间、HTTP 标头、返回到客户机的状态码，以及发送到客户机的文档的内容长度。
- Use Extended LogFile Format。包括通用日志文件格式的所有字段和一些其他字段，如远程状态、代理到客户机的内容长度、远程到代理的内容长度、代理到远程的内容长度、客户机到代理的标头长度、代理到客户机的标头长度、代理到远程的标头长度、远程到代理的标头长度以及传送时间。
- Use Extended2 LogFile Format。包括扩展日志文件格式的所有字段和一些其他字段，如客户机状态、服务器状态、远程状态、高速缓存完成状态以及实际路由。
- Only Log。使您可以选择要记录的信息。可以从表 9–3 中列出的灵活日志格式项进行选择。
- 如果选择自定义格式，请在 "Custom Format" 字段中键入该格式。

如果不想记录来自某主机名或 IP 地址的客户机访问，请在 "host names" 和 "IP Addresses" 字段中键入它们。

键入服务器不应记录其访问的主机的通配符模式。例如，*.example.com 将不记录域为 example.com 的用户的访问。可以为主机名、IP 地址，或同时为二者键入通配符模式。

选择是否在日志文件中包括格式字符串。

如果使用的是 Proxy Server 的日志分析程序，应包括格式字符串。如果使用的是第三方的分析程序，可能不需要在日志文件中包括格式字符串。

单击 "OK"。

单击 "Restart Required"。

此时将显示 "Apply Changes" 页面。

单击 "Restart Proxy Server" 按钮应用更改。