9.6　HTTPリクエストおよびサーブレット・フィルタのトレース

HTTPリクエストおよびサーブレット・フィルタのトレース情報が取得されます。HTTPリクエストおよびサーブレット・フィルタのトレースの一覧を次の表に示します。

表9‒3　HTTPリクエストおよびサーブレット・フィルタのトレースの一覧
シーケンス図との対応	イベントID	トレース取得ポイント	取得レベル	リターンコード（Rc）	インタフェース名（INT）	オペレーション情報（OPR）
トレース1	0xe230	HTTPリクエストを受信した直後	FINE	0	HTTPメソッド	リクエストURI^※3
トレース2	0xe231	HTTPレスポンスを送信する直前	FINE	正常リターンの場合：0 例外リターンの場合：1	HTTPメソッド	リクエストURI^※3
トレース3	0xe240	最初のサーブレットまたはフィルタを呼び出す直前^※1	FINE	0	サーブレット・フィルタ名^※2	リクエストURI^※3
トレース4	0xe241	最後のサーブレットの処理，または最初のフィルタの処理が完了した直後^※1	FINE	正常リターンの場合：0 例外リターンの場合：1	サーブレット・フィルタ名^※2	リクエストURI^※3

注※1: 1つのリクエストで複数のフィルタやサーブレットが呼び出される場合，最初に呼び出されるものだけがトレース取得の対象です。
注※2: Servlet4.0で追加されたjavax.servlet.ServletConfig.getServletNameメソッドで取得するため，このAPIがないTomcat 8.5では空文字（""）になります。Tomcat 9以降では，Webアプリケーションデプロイ記述子に記載している場合は記載した名前が取得されます。記載していない場合は実装依存の名前が取得されます。
注※3: URIにパスワードなどの機密情報が含まれていないことを確認してください。

トレース機能で取得された情報は，Tomcatトレースログに出力されます。詳細は，「13.3.1　Tomcatトレースログ」を参照してください。

トレース取得シーケンス

HTTPリクエストおよびサーブレット・フィルタのトレース取得シーケンスを次の図に示します。なお，図中の番号（トレース1など）は，「表9-3　HTTPリクエストおよびサーブレット・フィルタのトレースの一覧」と対応しています。

図9‒2　HTTPリクエストおよびサーブレット・フィルタのトレース取得シーケンス（同期リクエスト）

図9‒3　HTTPリクエストおよびサーブレット・フィルタのトレース取得シーケンス（非同期リクエスト）