报表服务器 HTTP 日志
报表服务器 HTTP 日志记录报表服务器所处理的所有 HTTP 请求和响应。由于请求溢出和超时错误不会到达报表服务器,因此这些错误不会记录在日志文件中。
默认情况下,不启用HTTP 日志记录。若要在安装中使用此功能,必须修改 ReportServerService.exe 配置文件。
查看日志信息
该日志为 ASCII 文本文件。可以使用任何文本编辑器查看该文件。报表服务器 HTTP 日志文件等同于 IIS 中的 W3C 扩展日志文件,并且使用与其类似的字段,因此可以使用现有的 IIS 日志文件查看器来读取报表服务器 HTTP 日志文件。下表提供有关 HTTP 日志文件的其他信息:
文件名 |
默认情况下,文件名为 ReportServerService_HTTP_<时间戳>.log。您可以通过在 ReportServerService.exe.config 文件中修改 HttpTraceFileName 属性来自定义文件名的前缀。时间戳基于协调世界时 (UTC)。 |
文件位置 |
该文件位于 \Microsoft SQL Server\<SQL Server Instance>\Reporting Services\LogFiles。 |
文件格式 |
该文件是 EN-US 格式。它是 ASCII 文本文件。 |
创建和保留文件 |
当您在配置文件中启用了日志、重新启动服务以及报表服务器处理 HTTP 请求时,会创建 HTTP 日志。如果您配置了相应的设置但并未看到日志文件,请打开报表或启动报表服务器应用程序(如报表管理器)以生成 HTTP 请求从而创建日志文件。 在各服务重新启动并且随后发生对报表服务器的 HTTP 请求时,会创建日志文件的新实例。 默认情况下,跟踪日志大小限制为 32 MB,并在 14 天后删除。 |
报表服务器 HTTP 日志的配置设置
若要配置报表服务器 HTTP 日志,请使用记事本来修改 ReportServerService.exe.config 文件。此配置文件位于 \Program Files\Microsoft SQL Server\MSSQL.n\Reporting Services\ReportServer\Bin 文件夹。
若要启用 HTTP 服务器,必须将 http:4 添加到 ReportServerService.exe.config 文件的 RStrace 部分。所有其他 HTTP 日志文件项都是可选的。下面的示例包括所有设置,因此您可以将整个内容都粘贴到 RStrace 部分,然后删除您不需要的设置。
<RStrace>
<add name="FileName" value="ReportServerService_" />
<add name="FileSizeLimitMb" value="32" />
<add name="KeepFilesForDays" value="14" />
<add name="Prefix" value="tid, time" />
<add name="TraceListeners" value="debugwindow, file" />
<add name="TraceFileMode" value="unique" />
<add name="HttpTraceFileName" value="ReportServerService_HTTP_" />
<add name="HttpTraceSwitches" value="date,time, clientip,username,serverip,serverport,host,method,uristem,uriquery,protocolstatus,bytesreceived,timetaken,protocolversion,useragent,cookiereceived,cookiesent,referrer" />
<add name="Components" value="all:3,http:4" />
</RStrace>
日志文件字段
下表对在日志中可用的字段进行了说明:该字段列表是可配置的;您可以通过 HTTPTraceSwitches 配置设置来指定要包括哪些字段。如果您不指定 HTTPTraceSwitches,则“默认”列会指定日志文件是否自动包含某个字段。
字段 |
说明 |
默认 |
---|---|---|
HttpTraceFileName |
此值为可选值。默认值为 ReportServerServiceHTTP_。如果您想要使用其他文件命名约定(例如,在将日志文件保存到中央位置时要包括服务器名),则可指定不同的值。 |
是 |
HttpTraceSwitches |
此值为可选值。如果指定该字段,则可以逗号分隔的格式配置要在日志文件中使用的字段。 |
否 |
Date |
活动发生的日期。 |
否 |
Time |
活动发生的时间。 |
否 |
ClientIp |
访问报表服务器的客户端的 IP 地址。 |
是 |
UserName |
访问报表服务器的用户的名称。 |
否 |
ServerPort |
连接使用的端口号。 |
否 |
Host |
主机标头的内容。 |
否 |
Method |
从客户端调用的操作或 SOAP 方法。 |
是 |
UriStem |
访问的资源。 |
是 |
UriQuery |
用于访问资源的查询。 |
否 |
ProtocolStatus |
HTTP 状态代码。 |
是 |
BytesReceived |
服务器接收的字节数。 |
否 |
TimeTaken |
从即时 HTTP.SYS 返回请求数据到服务器完成最后一次发送所用的时间(以毫秒计),不包括网络传输时间。 |
否 |
ProtocolVersion |
客户端使用的协议版本。 |
否 |
UserAgent |
客户端使用的浏览器类型。 |
否 |
CookieReceived |
服务器接收的 cookie 的内容。 |
否 |
CookieSent |
服务器发送的 cookie 的内容。 |
否 |
Referrer |
客户端以前访问过的站点。 |
否 |