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

  • [アーティクル]

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

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

ログ情報の表示

ログは、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 要求が処理されて初めて作成されます。 設定を構成したにもかかわらずログ ファイルが見つからない場合は、レポートを開くか、レポート サーバー アプリケーション (Web ポータルなど) を起動します。 このアクションにより、HTTP 要求を生成してログ ファイルを作成します。

ログ ファイルの新しいインスタンスは、各サービスが再開され、その後、HTTP 要求がレポート サーバーに送信されると作成されます。

既定では、トレース ログのサイズの上限は 32 MB であり、14 日後に削除されます。

レポート サーバーの HTTP ログの構成設定

レポート サーバーの HTTP ログを構成するには、メモ帳を使用して、ReportingServicesService.exe.config ファイルに変更を加えます。 構成ファイルは、\Program Files\Microsoft SQL Server\MSSQL.n\Reporting Services\ReportServer\Bin フォルダーに格納されています。

HTTP サーバーを有効にするには、ReportingServicesService.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を指定しなかった場合に、対応するフィールドがログ ファイルに自動的に追加されるかどうかを示しています。

フィールド 説明 Default
HttpTraceFileName この値は省略可能です。 既定値は ReportServerServiceHTTP_ です。 別のファイルの名前付け規則を使用する場合は、別の値を指定できます。 たとえば、ログ ファイルを中央の場所に保存する場合は、サーバー名を含めることができます。 はい
HTTPTraceSwitches この値は省略可能です。 指定した場合、ログ ファイルに使用するフィールドをコンマ区切り形式で構成できます。 いいえ
Date アクティビティが発生した日付。 いいえ
Time アクティビティが発生した時刻。 いいえ
ClientIp レポート サーバーにアクセスしているクライアントの IP アドレス。 はい
UserName レポート サーバーにアクセスしたユーザー名。 いいえ
ServerIp 接続に使用される IP アドレス。 いいえ
ServerPort 接続に使用されたポート番号。 いいえ
Host ホスト ヘッダーの内容。 いいえ
Method クライアントから呼び出されたアクションまたは SOAP メソッド。 はい
UriStem アクセスされたリソース。 はい
UriQuery リソースへのアクセスに使用されたクエリ。 いいえ
ProtocolStatus HTTP 状態コード。 はい
BytesReceived サーバーが受信したバイト数。 いいえ
TimeTaken HTTP.SYS が要求データを返してから、サーバーが最後の送信を完了するまでのミリ秒単位の時間 (ネットワークの伝送時間を除く)。 いいえ
ProtocolVersion クライアントが使用するプロトコル バージョン。 いいえ
UserAgent クライアントが使用しているブラウザーの種類。 いいえ
CookieReceived サーバーが受信したクッキーの内容。 いいえ
CookieSent サーバーによって送信されたクッキーの内容。 いいえ
Referrer クライアントが直前に訪問したサイト。 いいえ

関連するコンテンツ