IIS 7 でトレースを使用して失敗した要求のトラブルシューティング

[アーティクル]
12/12/2007

適用対象: インターネットインフォメーションサービス 7.0

注:

この記事は IIS 7.0 に適用されます。新しいバージョンについては、「 IIS 8.5 でトレースを使用して失敗した要求のトラブルシューティング」を参照してください。

要求ベースのトレースは、スタンドアロンの IIS サーバーと Azure Web アプリの両方で使用でき、要求で何が起こっているのか、発生している問題を再現できる場合の理由を判断する方法を提供します。一部の要求でのパフォーマンス低下や、他の要求での認証関連のエラー、または ASP または ASP.NET からのサーバー 500 エラーなどの問題は、問題が発生したときに問題のトレースをキャプチャしていない限り、トラブルシューティングが困難になる場合があります。この記事では、IIS サーバーでの失敗した要求トレースについて説明します。 Azure Web アプリでこれを実行する方法については、「Visual Studio を使用したAzure App Serviceアプリのトラブルシューティング」を参照してください。

失敗した要求トレースは、要求のトレースイベントをバッファー処理し、要求が失敗した場合にのみディスクにフラッシュするように設計されています。ここで、"failure" の定義を指定します。 404.2 エラーメッセージが表示される理由や要求のハングが発生する理由を知りたい場合は、失敗した要求トレースを使用します。

この記事で説明するタスクは次のとおりです。

失敗した要求トレースモジュールの有効化。
失敗した要求トレースログファイルセマンティクスの構成。
失敗した要求トレースを保持する URL (エラー定義やトレースする領域など) を定義する。
エラー状態を生成し、結果のトレースを表示する。

前提条件

IIS のインストール

この記事のタスクを実行するには、IIS 7 以上をインストールする必要があります。 http://localhost/ IIS がインストールされているかどうかを参照して確認します。 IIS がインストールされていない場合は、インストール手順については、「 Windows Server 2008 への IIS のインストール」を参照してください。 IIS をインストールするときは、次の機能もインストールしてください。

ASP.NET ( World Wide Web Services - アプリケーション開発機能 - ASP.NET の下)
トレース (World Wide Web Services - の正常性と診断トレースの - 下)

ログインに使用するアカウントが管理者アカウントであるか、Administrators グループ内にあることを確認します。

注:

Administrators グループに属している場合、既定では完全な管理者権限は付与されません。アプリケーションを管理者として実行する必要があります。そのためには、アプリケーションアイコンを右クリックし、[ 管理者として実行] を選択します。

バックアップを作成する

次のセクションのタスクを実行する前に、構成のバックアップを作成する必要があります。

構成のバックアップを作成するには、次の手順に従います。

[すべてのプログラムアクセサリを開始]を>選択します>。
[コマンドプロンプト] を右クリックし、[管理者として実行] を選択します。
コマンドプロンプトで、次のコマンドを実行します。
```
%windir%\system32\inetsrv\appcmd add backup cleanInstall
```

サンプルコンテンツを作成する

%systemdrive%\inetpub\wwwroot に移動します。
コンテンツをセキュリティで保護された場所に移動するか (既存のコンテンツを復元する場合に備えて)、削除します。
空のファイルを作成し、 test.aspという名前を付けます。
コマンドプロンプトで、\inetpub\wwwroot 内のtest.asp ファイルに移動します。

test.asp ファイルに、次の内容を貼り付けます。

<h2>Failed Request Tracing Lab</h2><br>
<br>Today's date is <% response.write(Date()) %>

ASP を無効にする

このタスクでは ASP を無効にする必要があります。 ASP は、例として、およびこの記事のタスクの目的でのみ無効になっています。

ASP を無効にするには

インターネットインフォメーションサービス (IIS) マネージャーを開きます。
ISAPI と CGI の制限をダブルクリックします。
[ Active Server Pages]\(アクティブサーバーページ\) を選択します。 [ 操作 ] ウィンドウで、[ 拒否 ] を選択して ASP を無効にします。

失敗した要求トレースを有効にする

失敗した要求トレースを有効にした後、ログファイルが存在する場所を構成する必要があります。このタスクでは、既定の Web サイトに対して失敗した要求トレースを有効にし、ログファイルを配置する場所を指定します。次に、エラーログを生成するエラーを構成します。

手順 1: サイトの失敗した要求トレースを有効にし、ログファイルディレクトリを構成する

管理者権限でコマンドプロンプトを開き、 %systemdrive%\windows\system32\inetsrv に移動します。
を実行 inetmgr して IIS マネージャーを開きます。
[Connections] ウィンドウで、コンピューター名を展開し、[サイト] を展開して、[既定の Web サイト] を選択します。
[ 操作 ] ウィンドウの [ 構成] で、[ 失敗した要求トレース] を選択します。
[ Web サイトの失敗した要求トレース設定の編集 ] ダイアログボックスで、次の構成を行います。
- [ 有効] チェックボックスをオンにします。
- 他の設定の既定値をそのまま使用します。
[OK] を選択します。

既定の Web サイトで失敗した要求トレースログが有効になりました。 %windir%\system32\inetsrv\config\applicationHost.config ファイルを確認して、構成が次のように表示されることを確認します。

<system.applicationHost>
   <sites> 
      <!-- site & app defaults --> 
      <site name="Default Web Site" id="1"> 
         <!-- other site configuration --> 
         <traceFailedRequestsLogging  enabled="true" /> 
      </site> 
   </sites> 
</system.applicationHost>

手順 2: エラー定義を構成する

この手順では、トレースする領域など、URL のエラー定義を構成します。まだ有効になっていない拡張機能に対する要求に対して IIS から返される 404.2 のトラブルシューティングを行います。これは、有効にする必要がある特定の拡張機能を決定するのに役立ちます。

管理者権限でコマンドプロンプトを開き、 %systemdrive%\windows\system32\inetsrv に移動します。
を実行 inetmgr して IIS マネージャーを開きます。
[Connections] ウィンドウで、コンピューター名を展開し、[サイト] を展開して、[既定の Web サイト] を選択します。
[失敗した要求トレース規則] をダブルクリックします。
[完了] を選択します。
[ 操作 ] ウィンドウで、[ 追加] を選択します。
[失敗した要求トレース規則の追加] ウィザードの [トレースするコンテンツの指定] ページで、[すべてのコンテンツ (*)] を選択します。 [次へ] を選択します。
[ トレース条件の定義 ] ページで、[ 状態コード ] チェックボックスをオンにし、トレースする状態コードとして 「404.2 」と入力します。
[次へ] を選択します。
[ トレースプロバイダーの選択 ] ページの [ プロバイダー] で、[ WWW サーバー ] チェックボックスをオンにします。 [ 領域] で、[ セキュリティ ] チェックボックスをオンにし、他のすべてのチェックボックスをオフにします。

生成中の問題により、セキュリティエラートレースイベントがスローされます。一般に、認証と承認 (ISAPI 制限リストの問題を含む) の問題は、トレースに WWW サーバー - セキュリティ領域の構成を使用して診断できます。ただし、 FREB.xsl スタイルシートはエラーと警告を強調表示するのに役立ちますので、既定の構成を使用して、すべての領域とプロバイダーのすべてのイベントをログに記録できます。 [ 詳細] で [詳細] を選択 します。
[完了] を選択します。 既定の Web サイトには、次の定義が表示されます。

IIS マネージャーは、タグを使用して構成を %windir%\system32\inetsrv\config\applicationHost.config ファイルに <location> 書き込みます。構成は次のようになります。

<location path="Default Web Site"> 
    <system.webServer> 
        <tracing> 
            <traceFailedRequests> 
                <add path="*"> 
                    <traceAreas> 
                        <add provider="WWW Server" areas="Security" verbosity="Verbose" /> 
                    </traceAreas> 
                    <failureDefinitions statusCodes="404.2" /> 
                </add> 
            </traceFailedRequests> 
        </tracing> 
    </system.webServer> 
</location>

エラー要求ログファイルをテストして表示する

このタスクでは、失敗した要求を生成し、結果のトレースログを表示します。 HTTP 応答コード 404.2 で失敗した要求のトレースログ http://localhost/*.asp をキャプチャするように IIS を既に構成しました。次に、動作することを確認します。

手順 1: エラーとエラー要求ログファイルを生成する

新しいインターネットエクスプローラーウィンドウを開きます。
次のアドレスを入力します。 http://localhost/test.asp
"HTTP エラー 404.2 - 見つかりません" エラーが表示されます。

手順 2: エラー要求ログファイルを表示する

失敗した要求を生成したら、管理者権限でコマンドプロンプトを開き、 %systemdrive%\inetpub\logs\FailedReqLogFiles\W3SVC1 に移動します。
start を実行して、ディレクトリからインターネットエクスプローラーウィンドウを起動します。
ここでいくつかの点に注意してください。IIS が失敗した要求ログファイルを書き込むと、失敗した要求ごとに 1 つのファイルが書き込まれます。 freb.xsl スタイルシートも、ディレクトリごとに 1 つずつ書き込まれます。これは、結果として得られるエラー要求ログファイル (このサンプル のfr000001.xml など) を表示するときに役立ちます。
404.2 エラーのログファイルを右クリックし、[インターネットエクスプローラーで>開く] を選択します。失敗した要求トレースファイルを初めて開く場合は、インターネットエクスプローラーのセキュリティ強化構成が既定で有効になっているため、信頼済みサイトの一覧に about:internet を追加する必要があります。その場合は、次の情報が表示されます。
[インターネットエクスプローラー] ダイアログボックスで、[追加...] を選択して、信頼されたサイトの一覧に about:internet を追加します。これにより、XSL が機能します。信頼されたサイトの一覧に about:internet を追加すると、次の内容が表示されます。

失敗した要求の概要が一番上に記録され、[エラー] & [警告] テーブルで、[重大度] の [警告]、[エラー]、または [重大なエラー] のいずれかのイベントが識別されます。この例では、警告の重大度レベルは ISAPI の制限によるものです。読み込もうとしたイメージは %windir%\system32\inetsrv\asp.dllでした。
テキストエディターを使用して生の XML ファイルを直接開き、各イベントの内容を確認します。

概要

2 つのタスクを完了しました。失敗した要求トレースを構成して、IIS が 404.2 状態コードで返す要求のトレースをキャプチャし、IIS が要求のトレースをキャプチャしたことを確認しました。また、要求に 404.2 のリターンコードがないため、 freb.xml ログファイルに、行った要求に対するその他の要求が含まれていないことも確認しました。エラーログファイルを参照すると、エラーの原因は、その要求に対して拡張機能が無効になっていると判断しました。他の HTML 以外のページ (.gif ファイルや .jpg ファイルなど) を試して、ログファイルでこれらのトレースが追加されないことに注意してください。また、これを 404 に簡単に変更したり、failureDefinitions で timeTaken フィールドを設定することで、要求に 30 秒を超える時間がかかる場合にエラーをキャプチャすることもできます。

バックアップを復元する

この記事のタスクを完了したので、構成のバックアップを復元できます。管理者権限で次のコマンドを実行します。

%windir%\system32\inetsrv\appcmd restore backup cleanInstall

IIS 7 でトレースを使用して失敗した要求のトラブルシューティング

前提条件

IIS のインストール

管理者としてサインインする

バックアップを作成する

サンプル コンテンツを作成する

ASP を無効にする

ASP を無効にするには

失敗した要求トレースを有効にする

手順 1: サイトの失敗した要求トレースを有効にし、ログ ファイル ディレクトリを構成する

手順 2: エラー定義を構成する

エラー要求ログ ファイルをテストして表示する

手順 1: エラーとエラー要求ログ ファイルを生成する

手順 2: エラー要求ログ ファイルを表示する

概要