• [アーティクル]

レポート サーバーの HTTP ログ

レポート サーバーの HTTP ログ ファイルには、レポート サーバーによって処理された HTTP 要求および HTTP 応答がすべて記録されます。要求のオーバーフローやタイムアウト エラーは、レポート サーバーに到達しないため、ログ ファイルには記録されません。

HTTP ログは既定では有効になっていません。環境内でこの機能を使用するためには、ReportServerService.exe の構成ファイルを変更する必要があります。

ログ情報の表示

ログは、ASCII テキスト ファイルです。任意のテキスト エディタでファイルを閲覧できます。レポート サーバーの HTTP ログ ファイルは、IIS における W3C 拡張ログ ファイルに相当し、同様のフィールドが使用されています。そのため、既存の IIS ログ ファイル ビューアを使用して、レポート サーバーの HTTP ログ ファイルを閲覧することもできます。次の表に、HTTP ログ ファイルの補足情報を示します。

ファイル名

既定のファイル名は ReportServerService_HTTP_<timestamp>.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 サーバーを有効にするには、ReportServerService.exe.config ファイルの RStrace セクションに「http:4」を追加する必要があります。その他の 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

クライアントが直前に訪問したサイト。

×