次の方法で共有

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

  • [アーティクル]

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

はじめに

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

失敗した要求トレースは、要求のトレース イベントをバッファーに格納し、要求が失敗した場合にのみディスクにフラッシュするように設計されています。ここでは、 failureの定義を指定します。 要求が特定の HTTP 状態コード (401 や 404 など) を返す理由を知りたい場合、または要求の処理に時間がかかっているか、応答していない場合は、失敗した要求トレースを使用できます。

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

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

前提条件

IIS のインストール

この記事で説明されているタスクを実行する前に、IIS 8.5 をインストールします。 http://localhost/ を参照し、インターネット インフォメーション サービスのスプラッシュ スクリーンが表示されていることを確認します。 IIS がインストールされていない場合のインストール手順については、「 Windows Server 2012 R2 への IIS 8.5 のインストール を参照してください。 IIS をインストールするときは、次の機能もインストールしてください。

  • ASP.NET 3.5 ( Web Server (IIS) /Web Server/アプリケーション開発機能/ASP.NET 3.5)
  • ASP.NET 4.5 ( Web Server (IIS) /Web Server/アプリケーション開発機能/ASP.NET 4.5)
  • トレース ( Web Server (IIS) /Web Server/Health and Diagnostics - Tracing)

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

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

Note

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

バックアップを作成する

次のタスクを実行する前に、構成ファイルのバックアップを作成します。

  1. Windows ロゴ キーと X キーを同時に選択し、 コマンド プロンプト (管理者) を選択し、 Yes を選択します。

    Windows タスク バーのコマンド プロンプト管理者のスクリーンショット。

  2. コマンドプロンプトで、次のコマンドを実行します。

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

    このコマンドは、バックアップ構成ファイルを含む cleanInstall フォルダーを %windir%\system32\inetsrv\backup に作成します。

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

  1. %systemdrive%\inetpub\wwwroot に移動します。

  2. コンテンツを安全な場所に移動するか (既存のコンテンツを復元する場合)、削除します。

  3. 空のファイルを作成し、 test.asp名前を付けます。

  4. コマンド プロンプトで、\inetpub\wwwroot 内のtest.asp ファイルに移動します。

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

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

ASP を無効にする

このタスクでは ASP を無効にする必要があります。 ASP を無効にするのは、あくまで例示であり、この記事のタスクの目的のためです。

ASP を無効にするには、次の手順に従います。

  1. IIS マネージャーを開き、サーバーを選択します。

  2. [ISAPI および CGI の制限] をダブルクリックします。

    選択した I S P I と C G I の制限が表示されている [I I S マネージャー] ウィンドウのスクリーンショット。

  3. [ISAPI および CGI の制限] ウィンドウで、[Active Server Pages] を選択します。 Actions ペインで Deny を選択して ASP を無効にします。 Active Server ページは、 許可されていませんとして表示されます。

    [Active Server Pages]\(アクティブ サーバー ページ\) が選択されている [I S A P I] と [C G I の制限] ウィンドウのスクリーンショット。[操作] ウィンドウで [拒否] オプションが選択されています。

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

失敗した要求トレースを有効にした後、ログ ファイルのパスを構成する必要があります。 このセクションでは、既定の Web サイトに対して失敗した要求トレースを有効にし、ログ ファイルを格納する場所を指定し、エラー ログを生成するエラーを構成します。

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

  1. 管理者権限でコマンド プロンプトを開き、 %systemdrive%\windows\system32\inetsrv に移動します。

  2. inetmgrを実行して IIS マネージャーを開きます。

  3. Connections ウィンドウで、コンピューター名を展開し、Sites を展開し、既定の Web サイトを選択します。

  4. [操作]ウィンドウの [構成] で、[失敗した要求のトレース] を選択します。

    [構成] タブで [失敗した要求トレース] オプションが強調表示されている [操作] ウィンドウのスクリーンショット。

  5. [Web サイトの失敗した要求トレース設定の編集] ダイアログ ボックスで、次の構成を行います。

    • [ 有効 ] チェック ボックスをオンにします。
    • 他の設定については、既定値をそのまま使用します。

    スクリーンショットには、[Edit Web Site Failed Request Tracing Settings]\(Web サイトの失敗した要求トレース設定の編集\) ダイアログ ボックスが表示され、コマンドが [ディレクトリ] フィールドに入力され、[有効] チェック ボックスがオンになっています。

  6. [OK] を選択します。

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

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

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

この手順では、トレースする領域を含め、URL のエラー定義を構成します。 まだ有効になっていない拡張機能への要求に対して IIS によって返される 404.2 状態コードのトラブルシューティングを行います。 これは、有効にする必要がある特定の拡張機能を決定するのに役立ちます。 詳細については、IIS のHTTP 状態コードを参照してください。

  1. 管理者権限でコマンド プロンプトを開き、 %systemdrive%\windows\system32\inetsrv に移動します。

  2. inetmgrを実行して IIS マネージャーを開きます。

  3. Connections ウィンドウで、コンピューター名を展開し、Sites を展開し、既定の Web サイトを選択します。

  4. [失敗した要求トレースの規則] をダブルクリックします。

    [失敗した要求トレース ルール] 機能が選択されていることを示す [既定の Web サイト ホーム] ウィンドウのスクリーンショット。

  5. Actions ペインで Add... を選択します。

  6. 失敗した要求トレース規則の追加 ウィザードの [トレースするコンテンツの指定] ページで、[すべてのコンテンツ (*) を選択し、 次へを選択します。

    失敗した要求トレースルールの追加ウィザードを示すスクリーンショット。[トレースするコンテンツの指定] ページで[すべてのコンテンツ]オプションが選択されています。

  7. [トレース条件の定義] ページで、[Status code(s)] チェック ボックスをオンにし、トレースする状態コードとして「404.2」と入力します。

    [トレース条件の定義] ページと状態コードとして入力された 404 ポイント 2 を示す失敗した要求トレース ルールの追加のスクリーンショット。

  8. [次へ] を選択します。

  9. トレース プロバイダーの選択 ページの Providersで、WWW サーバーチェック ボックスをオンにして、他のすべてのチェック ボックスをオフにします。 [ Areas で、 Security チェック ボックスをオンにし、他のすべてのチェック ボックスをオフにします。

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

  10. [詳細] の [詳細] を選択します。

    Note

    トレース役割サービスをインストールすると、IIS は既定で WWW サーバー、ASP、および ISAPI 拡張機能トレース プロバイダーをインストールします。 ASP.NET 2.0 以降をインストールすると、IIS によって ASPNET トレース プロバイダーが自動的に追加されます。 追加のプロバイダーは、アプリケーション要求ルーティング処理 (ARR) インストーラ パッケージによってインストールされます。このパッケージには、URL 書き換えモジュール、Web ファーム管理、外部キャッシュもインストールされます。 トレース プロバイダーをさらに追加するには、<traceProviderDefinitions> 要素内の <add> 要素を使用します。

    [プロバイダー] の一覧から WWW サーバーが選択され、[領域] メニューから [セキュリティ] が選択されていることを示す[失敗した要求トレース規則の追加ウィザード] のスクリーンショット。

  11. 完了 を選択します。

  12. Default Web サイトには、次の定義表示されます。

    WWW サーバーが関連付けられたプロバイダーとして入力され、404 ポイント 2 が状態コードとして入力されたことを示す [失敗した要求トレース ルール] ページのスクリーンショット。

    この構成は、IIS マネージャーによって %systemdrive%\inetpub\wwwroot\web.config ファイルに <location> タグを使用して書き込まれます。 構成では、次の値を再設定する必要があります。

    <configuration> 
    <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> 
</configuration>

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

このセクションでは、失敗した要求を生成し、結果のトレース ログを表示するのに役立ちます。 HTTP 応答コード 404.2 で失敗する http://localhost/*.asp 要求のトレース ログをキャプチャするように IIS を既に構成しました。 今度は、それが正しく動作することを確認します。

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

  1. 新しい Internet Explorer ウィンドウを開きます。

  2. http://localhost/test.aspを入力し、ENTER キーを押します。 "HTTP エラー 404.2 - 見つかりません" というエラー メッセージが表示されます。

    Internet Explorer ウィンドウに H T T P エラー 404 point 2 dash Not Found メッセージ ページが表示されているスクリーンショット。

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

  1. 失敗した要求を生成したら、エクスプローラーを開き、 %systemdrive%\inetpub\logs\FailedReqLogFiles\W3SVC1 に移動します。

    失敗した Req Log Files ディレクトリの W 3 S V C 1 フォルダーのスクリーンショット。

    Note

    IIS は、失敗した要求ログ ファイルを書き込むと、失敗した要求ごとに 1 つのファイルを書き込みます。 freb.xsl スタイル シートも、ディレクトリごとに 1 つ書き込まれます。 これは、結果として得られるエラー要求ログ ファイル (このサンプルの fr000001.xml など) を表示するときに役立ちます。

  2. 404.2 エラーのログ ファイルを右クリックし、[ 開く - >Internet Explorer を選択します。 失敗した要求トレース ファイルを初めて開く場合は、Internet Explorer のセキュリティ強化構成が既定で有効になっているため、信頼済みサイトの一覧に about:internet を追加する必要があります。 その場合は、次のように表示されます。

    [Web サイトのコンテンツがブロックされたときのプロンプトを続行する] オプションが選択されている Internet Explorer ダイアログ ボックスのスクリーンショット。

  3. Internet Explorer ダイアログ ボックスで、次の手順でabout:internetを信頼済みサイトの一覧に追加します。

    1. Tools メニューを選択し、Internet オプションを選択します。
    2. [セキュリティ] タブをクリックします。
    3. Trusted Zone を選択し、Sites を選択します。
    4. これで XSL が機能するようになります。

  4. 信頼済みサイトの一覧に about:internet を追加すると、[要求の概要] ページが表示されます。

    [要求の概要] ページのスクリーンショット。[エラーと警告] テーブルに重大度、イベント、モジュール名の列が表示されています。

    失敗した要求の概要が一番上に記録され、重大度がWARNING、ERROR、またはCRITICAL ERRORされるイベントを識別する Errors & Warnings テーブルが記録されます。 この例では、 WARNING 重大度レベルは ISAPI の制限によるものです。 読み込もうとしたイメージは、 %windir%\system32\inetsrv\asp.dllでした。

  5. テキスト エディターを使用して生の XML ファイルを直接開き、各イベントの内容を確認します。

まとめ

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

バックアップを復元する

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

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