すべてのサイトの失敗した要求トレース ログ <traceFailedRequestsLogging>
- 概要
- 互換性
- セットアップ
- 方法
- 構成
- サンプル コード
※本ページに挿入されている画像をクリックすると、画像全体が別ウィンドウで表示されます。
概要
<siteDefaults>
要素の <traceFailedRequestsLogging>
要素は、失敗した要求トレース ログ ファイルのディレクトリ、失敗した要求トレース ログ ファイルの最大数、失敗した要求トレースを有効にするかどうかなど、すべてのサイトの失敗した要求トレースの既定のオプションを設定します。
注 : 特定のサイトにおいて <siteDefaults>
セクションと <site>
セクションの両方で <traceFailedRequestsLogging>
要素が構成されている場合、そのサイトでは <site>
セクションの構成が使用されます。
注 : <siteDefaults>
要素の <traceFailedRequestsLogging>
要素は、失敗した要求トレースの既定のオプションを指定します。一方、<system.webServer/tracing/traceFailedRequests>
要素は、失敗した要求トレースの規則を指定します。
互換性
IIS 7.0 | IIS 6.0 | |
---|---|---|
説明 | <siteDefaults> の <traceFailedRequestsLogging> は IIS 7.0 で新たに導入された要素です。 |
なし |
セットアップ
失敗した要求トレースを使用するには、IIS 7.0 の既定のインストールが終了した後に、追跡の役割サービスをインストールする必要があります。また、この役割サービスをインストールした後には、サイト レベル、アプリケーション レベル、またはディレクトリ レベルで失敗した要求トレースを有効にする必要があります。
Windows Server 2008
タスク バーの [スタート] ボタンをクリックし、[管理ツール] をポイントして [サーバー マネージャー] をクリックします。
[サーバー マネージャー] のツリー表示で、[役割] を展開して [Web サーバー (IIS)] をクリックします。
[Web サーバー (IIS)] ウィンドウで、[役割サービス] セクションまでスクロールして [役割サービスの追加] をクリックします。
役割サービスの追加ウィザードの [役割サービスの選択] ページで、[トレース] を選択して、[次へ] をクリックします。
[インストール オプションの確認] ページで [インストール] をクリックします。
[結果] ページで [閉じる] をクリックします。
Windows Vista
タスク バーの [スタート] ボタンをクリックし、[コントロール パネル] をクリックします。
[コントロール パネル] の [プログラムと機能] をクリックして、[Windows の機能の有効化または無効化] をクリックします。
[Internet Information Services]、[World Wide Web サービス]、[健常性と診断] の順に展開します。
[追跡] を選択して、[OK] をクリックします。
方法
サーバーの既定の失敗した要求トレース設定を構成する方法
タスク バーの [スタート] ボタンをクリックして、[管理ツール] をポイントし、[インターネット インフォメーション サービス (IIS) マネージャー] をクリックします。
[接続] ウィンドウで、対象のサーバー名を展開し、[サイト] をクリックします。
サーバーの [サイト] ウィンドウで、[操作] ウィンドウにある [Web サイトの既定値の設定] をクリックします。
[Web サイトの既定値] ダイアログ ボックスで、[失敗した要求トレース] を展開し、すべての Web サイト向けの失敗した要求トレースのオプションを指定して、[OK] をクリックします。
構成
属性
属性 | 説明 |
---|---|
customActionsEnabled |
オプションの Boolean 属性。 失敗した要求トレースでカスタム アクションを有効にするかどうかを指定します。 既定値は false です。 |
directory |
オプションの string 属性。 サイトの失敗した要求トレース ログのディレクトリを指定します。 既定値は %SystemDrive%\inetpub\logs\FailedReqLogFiles です。 |
enabled |
オプションの Boolean 属性。 サイトの失敗した要求トレース ログを有効にするか (true)、または無効にするか (false) を指定します。 既定値は false です。 |
maxLogFiles |
オプションの uint 属性。 サイトで保持する失敗した要求トレース ログ ファイルの最大数を指定します。 既定値は 50 です。 |
maxLogFileSizeKB |
オプションの uint 属性。 失敗した要求トレース ログの最大ファイル サイズを KB 単位で指定します。 注 : 失敗した要求トレース ログがこの値を超えた場合、IIS によって最大ファイル サイズでログが切り捨てられ、トレース イベントに対して LOG_FILE_MAX_SIZE_TRUNCATE が指定されます。 既定値は 512 です。 |
子要素
なし。
構成サンプル
次の構成サンプルでは、IIS 7.0 の失敗した要求トレースの既定のオプションを指定します。
<system.applicationHost>
<sites>
<siteDefaults>
<traceFailedRequestsLogging enabled="true"
directory="%SystemDrive%\inetpub\logs\FailedReqLogFiles"
maxLogFiles="20" />
</siteDefaults>
</sites>
</system.applicationHost>
サンプル コード
次のコード サンプルでは、IIS 7.0 の失敗した要求トレースの既定のオプションを構成します。
AppCmd.exe
appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.traceFailedRequestsLogging.enabled:"True" /commit:apphost
appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.traceFailedRequestsLogging.directory:"%SystemDrive%\inetpub\logs\FailedReqLogFiles" /commit:apphost
appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.traceFailedRequestsLogging.maxLogFiles:"20" /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 traceFailedRequestsLoggingElement = siteDefaultsElement.GetChildElement("traceFailedRequestsLogging");
traceFailedRequestsLoggingElement["enabled"] = true;
traceFailedRequestsLoggingElement["directory"] = @"%SystemDrive%\inetpub\logs\FailedReqLogFiles";
traceFailedRequestsLoggingElement["maxLogFiles"] = 20;
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 traceFailedRequestsLoggingElement As ConfigurationElement = siteDefaultsElement.GetChildElement("traceFailedRequestsLogging")
traceFailedRequestsLoggingElement("enabled") = True
traceFailedRequestsLoggingElement("directory") = "%SystemDrive%\inetpub\logs\FailedReqLogFiles"
traceFailedRequestsLoggingElement("maxLogFiles") = 20
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 traceFailedRequestsLoggingElement = siteDefaultsElement.ChildElements.Item("traceFailedRequestsLogging");
traceFailedRequestsLoggingElement.Properties.Item("enabled").Value = true;
traceFailedRequestsLoggingElement.Properties.Item("directory").Value = "%SystemDrive%\\inetpub\\logs\\FailedReqLogFiles";
traceFailedRequestsLoggingElement.Properties.Item("maxLogFiles").Value = 20;
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 traceFailedRequestsLoggingElement = siteDefaultsElement.ChildElements.Item("traceFailedRequestsLogging")
traceFailedRequestsLoggingElement.Properties.Item("enabled").Value = True
traceFailedRequestsLoggingElement.Properties.Item("directory").Value = "%SystemDrive%\inetpub\logs\FailedReqLogFiles"
traceFailedRequestsLoggingElement.Properties.Item("maxLogFiles").Value = 20
adminManager.CommitChanges()