アプリケーション全体のトレースは、アプリケーションのルート ディレクトリの Web.config ファイルで有効にできます。デフォルトでは、アプリケーション レベルのトレースはローカル Web サーバー コンピュータでのみ表示できます。
アプリケーション レベルのトレース情報がリモート コンピューターから表示されるように、Web.config ファイルで localOnly を false に設定する
必要があります
。リモート トレースを無効にするには、Web.config ファイルで localOnly プロパティを true に設定します。
次の例は、最大 40 個のリクエストのトレース情報を
収集し、オリジン サーバー以外のマシン上のブラウザでトレース ビューアを表示できるようにするアプリケーション トレース構成を示しています
。
<構成>
<システム.ウェブ>
<trace Enabled="true" requestLimit="40" localOnly="false"/>
</system.web>
</設定>
アプリケーションのトレースを有効にすると、ASP.NET は、指定した要求の最大数に達するまで、アプリケーションへの各要求のトレース情報を収集します。デフォルトのリクエスト数は 10 です。トレース ビューアが
リクエストの制限に達すると、アプリケーションはトレース リクエストの保存を停止します。
注 Web.config ファイルでアプリケーション全体のトレースを有効にすると、アプリケーションのページごとにトレース情報が収集および処理されます。アプリケーションの特定のページのトレースを無効にするには、
ページの @Page ディレクティブで Trace プロパティを false に設定します。ページ コードに含めた TraceContext.Write または TraceContext.Warn ステートメントはすべて保存され
、
Trace Viewer にのみ返されます。
トレース情報を、関連付けられているページの末尾に追加する場合は、Web.config ファイルのトレース構成セクションで pageOutput プロパティを true に設定します。
トレース ビューア
にのみ表示したい場合は
、このプロパティを false に設定します。アプリケーション レベルのトレースを有効にしても、アプリケーションの特定のページではトレース情報を表示したくない場合は、@Page ディレクティブを使用して、
トレース情報を表示したくないページの Trace プロパティを false に設定します。
以下は、アプリケーションレベルのトレース動作を変更するために使用できるすべてのプロパティです。
プロパティの説明
アプリケーションレベルのトレースが有効な場合は true、それ以外の場合は false。デフォルト値は false です。
pageOutput トレース情報がアプリケーション ページと .axd トレース ユーティリティの両方に表示される場合は true、それ以外の場合は false。デフォルト値は false です。
注: 追跡が有効になっているページは、この設定の影響を受けません。
requestLimit サーバーに保存されている追跡リクエストの数。デフォルト値は 10 です。
traceMode は、トレース情報が処理された順序 (SortByTime) で表示されるか、ユーザー定義のカテゴリによるアルファベット順 (SortByCategory) で表示されるかを示します。デフォルト値は
SortByTime です。
localOnly トレース ビューア (Trace.axd) がホスト Web サーバーでのみ使用できる場合は true、それ以外の場合は false。デフォルト値は true です。
アプリケーション レベルのトレースを有効にする
まだ作成していない場合は、テキスト ファイルを作成し、Web.config という名前を付けて、アプリケーションのルート ディレクトリに保存します。
<configuration> 要素の開始タグと終了タグの間に、<system.web> 要素の開始タグと終了タグを追加します。
<system.web> 要素タグの間に、<trace> 要素を追加します (自己終了要素です)。
<trace> 要素で、enabled 属性を宣言し、true に設定します。
他のオプションのプロパティを宣言して、ニーズに合わせてアプリケーションの追跡動作を変更します。
たとえば、次のアプリケーション トレース構成では、最大 40 件のリクエストのトレース情報が収集され、オリジン サーバー以外のマシン上のブラウザでトレース ビューアを表示できるようになります。
<構成>
<システム.ウェブ>
<trace Enabled="true" requestLimit="40" localOnly="false"/>
</system.web>
</設定>
ASP.NET 構成システムでは大文字と小文字が区別されることに注意してください。すべての 1 単語の構成セクションは小文字ですが、2 つの単語が連結されたセクションまたは属性はキャメルケースである必要があります。たとえば、
requestLimit は有効なプロパティ名ですが、requestlimit ではパーサー エラーが発生します。
Trace Viewer によるトレース情報の表示 アプリケーション レベルのトレースが有効になると、アプリケーションの各ページが要求されると、そこに含まれるトレース ステートメントが実行されます。
、アプリケーションのルート ディレクトリにある Trace.axd を要求することによって、
トレース
ビューアで表示できます。注 アプリケーション レベルのトレースが有効な場合、Web.config ファイルで pageOutput プロパティを true に設定することにより、アプリケーションの任意のページでトレース ステートメントおよび
その他の
情報を表示できます。
トレース ビューアを使用すると、アプリケーションからリクエストされたページの中から特定のリクエストを選択できます。以下のスクリーンショットは、トレースが有効になった後、
アプリケーション
に対して 7 つのリクエストがあるトレース ビューアを示しています。トレース ビューア トレース
が有効なアプリケーションに複数のリクエストが到着した場合、トレース ビューアはそれらのリクエストを処理された順序でリストします。トレース ビューアの開始ページの情報には、リクエストの時刻、
リクエストされたファイル、リクエストのステータス コード、リクエストに関連付けられた HTTP 動詞、およびリクエストに関する詳細情報を表示できる「詳細を表示」リンクが含まれます。表示されるリクエストの数は、
Web.config ファイルで指定した requestLimit 設定を超えることはありません。
特定のリクエストのトレースの詳細を表示するには、
アプリケーションに関連付けられたトレース ビューアに移動します。
たとえば、アプリケーションの URL がhttp://localhost/myapplicationの場合、 http://localhost/myapplication/trace.axdに移動して、アプリケーションの
トレース
統計を表示します。調査したいリクエストの「詳細を表示」リンクを選択します。
[詳細の表示] を選択すると、追跡が有効なページに同じ情報が追加されて表示されます。
場合によっては、トレース ビューアに保存されているすべてのリクエストを削除することが必要になる場合があります。アプリケーション内のファイルに加えられた変更を追跡したい場合や、
現在表示されているリクエストに関連付けられているファイル以外のファイルに関する情報を単に確認したい場合もあります。
Clear from Trace Viewer リクエストは、
アプリケーションに関連付けられたトレース ビューアをターゲットとしています。
「Clear Current Trace」リンクを選択して、Trace Viewer アプリケーションに保存されているすべてのリクエストを削除します。
注 トレース ビューアは、レコードがクリアされた後に行われたリクエストのみをトレースします。リクエスト制限に達した後、レコードがクリアされる前に行われたリクエストは表示できません。