W3C 日志记录

  • 项目

W3C 扩展日志记录是可在服务器会话或 URL 组上启用的服务器端日志记录类型。 在 URL 组上启用 W3C 日志记录时，仅对路由到 URL 组的请求执行日志记录。 为每个配置为启用 W3C 日志记录的 URL 组创建单独的日志文件。

在服务器会话上启用 W3C 日志记录时，它充当服务器会话下所有 URL 组的集中式日志记录形式。 为服务器会话中的所有 URL 组维护单个日志文件。

下表列出了 HTTP 服务器 API 可以记录的字段。 表包含 HTTP_LOG_FIELD 常量的子集。 下面列出的某些字段由 HTTP 服务器 API 在内部自动生成，因此不包含在 HTTP_LOG_FIELDS_DATA 结构中。 “显示为”列包含日志文件中显示的文本。 表中的数据按日志文件记录中的出现顺序排列。

未标记为“生成的 HTTP 服务器 API”的字段必须由应用程序在 HTTP_LOG_FIELDS_DATA 结构内传递。 应用程序可以从传递给它的 HTTP_REQUEST 结构生成这些字段。

字段 显示为 说明 HTTP_LOG_FIELDS_DATA 成员 HTTP_LOG_FIELDS常量
日期 date 活动发生的日期。 生成的 HTTP 服务器 API。 HTTP_LOG_FIELD_DATE
时间 time 时间（以协调世界时 (UTC) 发生活动的时间）。 生成的 HTTP 服务器 API。 HTTP_LOG_FIELD_TIME
服务名称和实例编号 s-sitename 客户端上运行的 Internet 服务名称和实例编号。 ServiceName HTTP_LOG_FIELD_SITE_NAME
服务器名称 s-computername 生成日志文件条目的服务器的名称。 ServerName HTTP_LOG_FIELD_COMPUTER_NAME
服务器 IP 地址 s-ip 生成日志文件条目的服务器的 IP 地址。 ServerIp HTTP_LOG_FIELD_SERVER_IP
方法 cs-method 请求的谓词，例如 GET 方法。 方法 HTTP_LOG_FIELD_METHOD
URI 词干 cs-uri-stem 谓词的目标，例如，Default.htm。 UriStem HTTP_LOG_FIELD_URI_STEM
URI 查询 cs-uri-query 客户端尝试执行的查询（如果有）。 只有动态页面才需要统一资源标识符 (URI) 查询。 UriQuery HTTP_LOG_FIELD_URI_QUERY
服务器端口 s-port 为服务配置的服务器端口号。 ServerPort HTTP_LOG_FIELD_SERVER_PORT
用户名 cs-username 访问服务器的经身份验证的用户名。 匿名用户会以连字符表示。 UserName HTTP_LOG_FIELD_USER_NAME
客户端 IP 地址 c-ip 发出请求的客户端的 IP 地址。 ClientIp HTTP_LOG_FIELD_CLIENT_IP
协议版本 cs-version 客户端使用的 HTTP 协议版本。 生成的 HTTP 服务器 API。 HTTP_LOG_FIELD_VERSION
用户代理 cs (User-Agent) 客户端使用的浏览器类型。 UserAgent HTTP_LOG_FIELD_USER_AGENT
Cookie cs (Cookie) 发送或接收的 Cookie 的内容（如果有）。 Cookie HTTP_LOG_FIELD_COOKIE
Referrer cs (引用) 用户上次访问的网站。 此站点提供指向当前站点的链接。 Referrer HTTP_LOG_FIELD_REFERRER
主机 cs-host 主机标头名称（如果有）。 主机 HTTP_LOG_FIELD_HOST
HTTP 状态 sc-status HTTP 状态代码。 ProtocolStatus HTTP_LOG_FIELD_STATUS
协议子状态 sc-substatus 子状态错误代码。 SubStatus HTTP_LOG_FIELD_SUB_STATUS
Win32 状态 sc-win32-status Windows 状态代码。 Win32Status HTTP_LOG_FIELD_WIN32_STATUS
发送的字节数 sc-bytes 服务器发送的字节数。 生成的 HTTP 服务器 API。 HTTP_LOG_FIELD_BYTES_SENT
接收的字节数 cs-bytes 服务器接收和处理的字节数。 生成的 HTTP 服务器 API。 HTTP_LOG_FIELD_BYTES_RECV
所用时间 所花费的时间 操作所用的时间长度（以毫秒为单位）。 生成的 HTTP 服务器 API。 HTTP_LOG_FIELD_TIME_TAKEN
流 ID streamid 流 ID。 生成的 HTTP 服务器 API。 HTTP_LOG_FIELD_STREAM_ID

 

日志文件是基于文本的可自定义 ASCII 格式。 文件中的字段前缀定义如下：

前缀 说明
s 服务器操作。
c 客户端操作。
Sc 服务器到客户端操作。
cs 客户端到服务器操作。

 

应用程序可以选择一个或多个 W3C 扩展日志文件字段，但并非所有字段都将包含信息。 对于已选择但没有任何信息的字段， () 的连字符显示为占位符。 如果字段包含不可打印的字符，HTTP 服务器 API 会将它替换为加号 (+) 以保留日志文件格式。 这通常发生在病毒攻击中，例如，当恶意用户发送回车和换行符时，如果不将其替换为加号 (+) ，则会破坏日志文件的格式。 字段由空格分隔。

如果某个字段由 URL 组或服务器会话启用，但未为请求选择该字段，则该字段会显示在日志文件中，其中包含 () 作为占位符的连字符。

当第一个请求到达 URL 组或服务器会话时，会创建日志文件，在配置日志记录时不会创建日志文件。 以下示例演示启用了客户端 IP、用户名、服务器 IP、服务器端口、方法、URI 词干、URI 查询、状态和用户代理字段的 W3C 日志文件的第一个日志文件条目：

#Software: Microsoft HTTP Server API 2.0  
#Version: 1.0   // the log file version as it's described by "https://www.w3.org/TR/WD-logfile".
#Date: 2002-05-02 17:42:15  // when the first log file entry was recorded, which is when the entire log file was created.
#Fields: date time c-ip cs-username s-ip s-port cs-method cs-uri-stem cs-uri-query sc-status cs(User-Agent)
2002-05-02 17:42:15 172.22.255.255 - 172.30.255.255 80 GET /images/picture.jpg - 200 Mozilla/4.0+(compatible;MSIE+5.5;+Windows+2000+Server)

当 HTTP 服务器 API 在分析请求之前收到第一个字节时，将初始化所花费的时间字段。 上次发送完成时，所花费的时间时间戳将停止。 所花费的时间并不反映整个网络的时间。 对站点的第一个请求显示的时间比其他类似请求稍长一些，因为 HTTP 服务器 API 使用第一个请求打开日志文件。