报表服务器 HTTP 日志
Reporting Services报表服务器 HTTP 日志文件保留报表服务器处理的每个 HTTP 请求和响应的记录。 由于请求溢出和超时错误不会到达报表服务器,因此这些错误不会记录在日志文件中。
默认情况下,不启用 HTTP 日志记录。 若要启用 HTTP 日志记录,请修改 ReportingServicesService.exe.config 配置文件,以便在安装中使用此功能。
查看日志信息
该日志为 ASCII 文本文件。 可以使用任何文本编辑器查看该文件。 报表服务器 HTTP 日志文件等同于 IIS 中的 W3C 扩展日志文件,并且使用与其类似的字段,因此可以使用现有的 IIS 日志文件查看器来读取报表服务器 HTTP 日志文件。 下表提供有关 HTTP 日志文件的其他信息:
文件名 | 默认情况下,日志文件名是ReportServerService_HTTP_<timestamp>.log. 您可以通过在 ReportingServicesService.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 日志,请使用记事本修改 ReportingServicesService.exe.config 文件。 此配置文件位于 \Program Files\Microsoft SQL Server\MSSQL.n\Reporting Services\ReportServer\Bin 文件夹。
若要启用 HTTP 服务器,请将 http:4
添加到 ReportingServicesService.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 | 此值是可选的。 如果指定该字段,则可以逗号分隔的格式配置要在日志文件中使用的字段。 | 否 |
日期 | 活动发生的日期。 | 否 |
时间 | 活动发生的时间。 | 否 |
ClientIp | 访问报表服务器的客户端的 IP 地址。 | 是 |
UserName | 访问报表服务器的用户的名称。 | 否 |
ServerPort | 连接使用的端口号。 | 否 |
主机 | 主机标头的内容。 | 否 |
方法 | 从客户端调用的操作或 SOAP 方法。 | 是 |
UriStem | 访问的资源。 | 是 |
UriQuery | 用于访问资源的查询。 | 否 |
ProtocolStatus | HTTP 状态代码。 | 是 |
BytesReceived | 服务器接收的字节数。 | 否 |
TimeTaken | 从即时 HTTP.SYS 返回请求数据到服务器完成最后一次发送所用的时间(以毫秒计),不包括网络传输时间。 | 否 |
ProtocolVersion | 客户端使用的协议版本。 | 否 |
UserAgent | 客户端使用的浏览器类型。 | 否 |
CookieReceived | 服务器接收的 cookie 的内容。 | 否 |
CookieSent | 服务器发送的 cookie 的内容。 | 否 |
Referrer | 客户端以前访问过的站点。 | 否 |
另请参阅
报表服务器服务跟踪日志
Reporting Services 日志文件和来源
错误和事件参考 (Reporting Services)