test

Sun Java System Web Proxy Server 4.0.8 管理指南

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

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

表 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

此字段指定高速缓存文件是被写入、刷新还是由最新版本检查返回。 

cs 字段可包含以下内容之一： 

- 表示资源无法高速缓存。 

WRITTEN 表示已创建高速缓存文件。 

REFRESHED 表示已更新或已刷新高速缓存文件。 

NO-CHECK 表示已返回高速缓存文件，没有进行最新版本检查。 

UP-TO-DATE 表示已返回高速缓存文件，进行了最新版本检查。 

HOST-NOT-AVAILABLE 表示远程服务器不能执行最新版本检查，因此已返回高速缓存文件，但未进行检查。 

CL-MISMATCH 表示因内容长度不匹配而中止了高速缓存文件写入。 

ABORTED 表示因特殊原因中止了高速缓存。例如，缺少有效的 Last-Modified 标头。 

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

验证期间提供给远程服务器的用户名。 

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

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

  2. 单击 "Set Access Log Preferences" 链接。

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

  3. 从下拉式列表中选择资源，或单击 "Regular Expression" 按钮，键入正则表达式，然后单击 "OK"。

  4. 指定是否记录客户机类。

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

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

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

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

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

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

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

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

    服务器访问日志格式可以为通用日志文件格式、扩展日志文件格式、扩展 2 日志文件格式、灵活日志格式或单独的可自定义格式。通用日志文件格式是普遍受支持的格式，可提供服务器的固定信息。灵活日志格式使您可以（从 Proxy Server）选择要记录的内容。可自定义的格式使用参数块，用户可以指定这些参数块来控制记录的内容。

    • Use Common LogFile Format。包括客户机的主机名、经过验证的用户名、请求的日期和时间、HTTP 标头、返回到客户机的状态码，以及发送到客户机的文档的内容长度。

    • Use Extended LogFile Format。包括通用日志文件格式的所有字段和一些其他字段，如远程状态、代理到客户机的内容长度、远程到代理的内容长度、代理到远程的内容长度、客户机到代理的标头长度、代理到客户机的标头长度、代理到远程的标头长度、远程到代理的标头长度以及传送时间。

    • Use Extended2 LogFile Format。包括扩展日志文件格式的所有字段和一些其他字段，如客户机状态、服务器状态、远程状态、高速缓存完成状态以及实际路由。

    • Only Log。使您可以选择要记录的信息。可从表 9–3 中列出的灵活日志格式项中进行选择。

    • 如果选择一种自定义格式，请在 "Custom Format" 字段中键入该格式。

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

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

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

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

  11. 单击 "OK"。

  12. 单击 "Restart required"。

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

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