Web サイトの既定のログ ファイル設定 <logFile>

概要

<siteDefaults> 要素の <logFile> 要素には、IIS 7 以降のサイトの既定のログ記録を構成できる属性が含まれています。

たとえば、ログ記録を有効または無効にしたり、IIS ログ ファイルの形式を構成したり、ログ ファイルに格納する情報のカテゴリを指定したり、ログ ファイルが格納されるディレクトリを変更したりできます。 また <logFile> 要素を使用して、ログ ファイルのサイズまたは時間間隔のいずれかに基づいて IIS で新しいログ ファイルが作成される頻度を制御したり、ログ ファイルが到達可能な最大サイズ (バイト単位) を制御したりできます。

既定では、IIS 7 以降では World Wide Web コンソーシアム (W3C) ログ ファイル形式が使用されます。 この設定を変更するには、logFormat 属性を IIS、NCSA、または Custom に変更します。

• <odbcLogging> 要素内の ODBC ログ属性を設定します。 これらの属性では、ODBC 接続のシステム データ ソース名 (DSN)、テーブル名、ユーザー名、およびパスワードを指定します。
• <logFile> 要素で適切なカスタム ログ属性を設定します。 これらの属性では、ログ ファイル形式を "Custom" に設定し、カスタム ログ プラグイン クラス ID を "{FF16065B-DE82-11CF-BC0A-00AA006111E0}" に設定する必要があります。

ODBC ログの詳細については、<odbcLogging> 要素を参照してください。

logExtFileFlags 属性を編集することで、IIS がログする情報のカテゴリを定義できます。 既定値は Date、Time、ClientIP、UserName、ServerIP、Method、UriStem、UriQuery、TimeTaken、HttpStatus、Win32Status、ServerPort、UserAgent、HttpSubStatus、Referer です。

IIS 8.5 を使用すると、標準のログ セットに加えて、カスタム フィールドをログできます。 カスタム フィールドを追加するには、ログ ファイル形式が W3C である必要があります。 詳細については、customFieldsを参照してください。

互換性

段取り

<logFile> 要素は IIS 7 以降の既定のインストールに含まれています。

操作方法

サーバーの既定のログ設定を編集する方法

1. インターネット インフォメーション サービス (IIS) マネージャーを開きます。

   • Windows Server 2012 または Windows Server 2012 R2 を使用している場合:

     • タスク バーで、[サーバー マネージャー] をクリックし、[ツール]、[インターネット インフォメーション サービス (IIS) マネージャー] の順にクリックします。

   • Windows 8 または Windows 8.1 を使用している場合:

     • Windows キーを押しながら文字 X を押し、[コントロール パネル] をクリックします。
     • [管理ツール] をクリックし、[インターネット インフォメーション サービス (IIS) マネージャー] をダブルクリックします。

   • Windows Server 2008 または Windows Server 2008 R2 を使用している場合:

     • タスク バーで、[スタート] ボタンをクリックし、[管理ツール]、[インターネット インフォメーション サービス (IIS) マネージャー] の順にクリックします。

   • Windows Vista または Windows 7 を使用している場合:

     • タスク バーで、[スタート]、[コントロール パネル] の順にクリックします。
     • [管理ツール] をダブルクリックし、次に [インターネット インフォメーション サービス (IIS) マネージャー] をダブルクリックします。

2. [接続] ペインで、ログを構成するサーバー名をクリックします。

3. [ホーム] ペインで、[ログ記録] をダブルクリックします。
   

4. [ログ記録] ペインの [形式] ボックスで、ログ ファイル形式を選び、ログ ファイルを格納するディレクトリへのパスを [ディレクトリ] ボックスに入力するか、[参照...] をクリックして、ログ ファイルを格納するディレクトリを選びます。
   

5. W3C ログ ファイル形式を使用する場合:

   • [フィールドの選択] をクリックしてログする情報の種類を選びます。
   • [W3C ログ記録フィールド] ダイアログ ボックスで、ログするオプションのチェック ボックスをオンにし、ログしないオプションのチェック ボックスをオフにして、[OK] をクリックします。
     

W3C ログに対して ETW またはファイル ログを構成する方法

1. インターネット インフォメーション サービス (IIS) マネージャーを開きます。

   • Windows Server 2012 R2 を使用している場合:

     • タスク バーで、[サーバー マネージャー] をクリックし、[ツール]、[インターネット インフォメーション サービス (IIS) マネージャー] の順にクリックします。

   • Windows 8.1 を使用している場合:

     • Windows キーを押しながら文字 X を押し、[コントロール パネル] をクリックします。
     • [管理ツール] をクリックし、次に [インターネット インフォメーション サービス (IIS) マネージャー] をダブルクリックします。

2. [接続] ペインで、サーバー名を展開します。

3. サイトのホーム ペインで、[ログ記録] をダブルクリックします。

4. [ログ記録] ホーム ページの [ログのイベントの保存先] で、[ログ ファイルのみ]、[ETW イベントのみ]、または [ログ ファイルと ETW イベントの両方] を選びます。

   

エントリ数による W3C ログのフラッシュを構成する方法

1. インターネット インフォメーション サービス (IIS) マネージャーを開きます。

   • Windows Server 2012 R2 を使用している場合:

     • タスク バーで、[サーバー マネージャー] をクリックし、[ツール]、[インターネット インフォメーション サービス (IIS) マネージャー] の順にクリックします。

   • Windows 8.1 を使用している場合:

     • Windows キーを押しながら文字 X を押し、[コントロール パネル] をクリックします。
     • [管理ツール] をクリックし、次に [インターネット インフォメーション サービス (IIS) マネージャー] をダブルクリックします。

2. [接続] ペインでサーバーを選び、[構成エディター] をダブルクリックします。

3. 構成エディターの [セクション] で system.applicationHost を展開し、次に sites を選びます。

4. siteDefaults を展開してから、logFile を展開します。

5. flushByEntryCountW3Clog について、ログ ファイルにフラッシュされる前にバッファーに格納するイベント数を入力します。

6. [操作] ペインで [適用] をクリックします。

   

ログの行の最大長を構成する方法

1. インターネット インフォメーション サービス (IIS) マネージャーを開きます。

   • Windows Server 2012 R2 を使用している場合:

     • タスク バーで、[サーバー マネージャー] をクリックし、[ツール]、[インターネット インフォメーション サービス (IIS) マネージャー] の順にクリックします。

   • Windows 8.1 を使用している場合:

     • Windows キーを押しながら文字 X を押し、[コントロール パネル] をクリックします。
     • [管理ツール] をクリックし、次に [インターネット インフォメーション サービス (IIS) マネージャー] をダブルクリックします。

2. [接続] ペインでサーバーを選び、次に [構成エディター] をダブルクリックします。

3. 構成エディターの [セクション] で system.applicationHost を展開し、次に sites を選びます。

4. siteDefaults を展開してから、logFile を展開します。

5. maxLogLineLength について、ログ ファイルの 1 行の最大バイト数を入力します。

6. [操作] ペインで [適用] をクリックします。

   

構成

属性

子要素

構成サンプル

次の構成サンプルでは、既定の logFile オプションを指定します。

<system.applicationHost>
   <sites>
      <siteDefaults>
         <logFile logFormat="W3C"
            directory="%SystemDrive%\inetpub\logs\LogFiles"
            enabled="true">
            <customFields>
               <clear/>
               <add logFieldName="ContosoField" sourceName="ContosoSource"
                  sourceType="ServerVariable" />
            </customFields>
         </logFile>
      </siteDefaults>
   </sites>
</system.applicationHost>

サンプル コード

次のコード サンプルでは、IIS 7 に対して既定の logFile オプションを構成します。

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.logFile.enabled:"True" /commit:apphost
appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.logFile.logFormat:"W3C" /commit:apphost
appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.logFile.directory:"%SystemDrive%\inetpub\logs\LogFiles" /commit:apphost

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample
{
   private static void Main()
   {
      using (ServerManager serverManager = new ServerManager())
      {
         Configuration config = serverManager.GetApplicationHostConfiguration();
         ConfigurationSection sitesSection = config.GetSection("system.applicationHost/sites");
         ConfigurationElement siteDefaultsElement = sitesSection.GetChildElement("siteDefaults");

         ConfigurationElement logFileElement = siteDefaultsElement.GetChildElement("logFile");
         logFileElement["logFormat"] = @"W3C";
         logFileElement["directory"] = @"%SystemDrive%\inetpub\logs\LogFiles";
         logFileElement["enabled"] = true;

         serverManager.CommitChanges();
      }
   }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration

Module Sample

   Sub Main()
      Dim serverManager As ServerManager = New ServerManager
      Dim config As Configuration = serverManager.GetApplicationHostConfiguration
      Dim sitesSection As ConfigurationSection = config.GetSection("system.applicationHost/sites")
      Dim siteDefaultsElement As ConfigurationElement = sitesSection.GetChildElement("siteDefaults")

      Dim logFileElement As ConfigurationElement = siteDefaultsElement.GetChildElement("logFile")
      logFileElement("logFormat") = "W3C"
      logFileElement("directory") = "%SystemDrive%\inetpub\logs\LogFiles"
      logFileElement("enabled") = True

      serverManager.CommitChanges()
   End Sub

End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST");
var siteDefaultsElement = sitesSection.ChildElements.Item("siteDefaults");

var logFileElement = siteDefaultsElement.ChildElements.Item("logFile");
logFileElement.Properties.Item("logFormat").Value = "W3C";
logFileElement.Properties.Item("directory").Value = "%SystemDrive%\\inetpub\\logs\\LogFiles";
logFileElement.Properties.Item("enabled").Value = true;

adminManager.CommitChanges();

VBScript

Set adminManager = WScript.CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")
Set siteDefaultsElement = sitesSection.ChildElements.Item("siteDefaults")

Set logFileElement = siteDefaultsElement.ChildElements.Item("logFile")
logFileElement.Properties.Item("logFormat").Value = "W3C"
logFileElement.Properties.Item("directory").Value = "%SystemDrive%\inetpub\logs\LogFiles"
logFileElement.Properties.Item("enabled").Value = True

adminManager.CommitChanges()