15.9　HTTPリクエストのトレース

HTTPリクエストのトレース情報が取得されます。HTTPリクエストのトレースの一覧を次の表に示します。

なお，Spring WebFluxを使用する場合，次のトレースは取得されません。

• 0xe231（HTTPレスポンスを送信する直前（トレース2））

• 0xe240（最初のサーブレットまたはフィルタを呼び出す直前（トレース3））

• 0xe241（最後のサーブレットの処理，または最初のフィルタの処理が完了した直後（トレース4））

• 0xe332（org.springframework.web.servlet.DispatcherServletによってHandlerを実行するとき（トレース7））

• 0xe333（org.springframework.web.servlet.DispatcherServletによってHandlerを実行したあと（トレース8））

• 0xe334（org.springframework.web.servlet.DispatcherServletによってViewレンダリングしたあと（トレース9））

• 0xe335（org.springframework.web.servlet.DispatcherServletによって非同期HTTPリクエスト処理を開始したあと（トレース10））

  表15‒7　HTTPリクエストのトレースの一覧

  シーケンス図との対応	イベントID	トレース取得ポイント	取得レベル	リターンコード（Rc）	インターフェイス名（INT）	オペレーション情報（OPR）
  トレース1	0xe230	HTTPリクエストを受信した直後	FINE	0	HTTPメソッド	リクエストURI※3
  トレース2	0xe231	HTTPレスポンスを送信する直前	FINE	ステータスコードが400未満の場合：0 ステータスコードが400以上の場合：1	HTTPメソッド	リクエストURI※3
  トレース3	0xe240	最初のサーブレットまたはフィルタを呼び出す直前※1	FINER	0	サーブレット・フィルタ名※2	リクエストURI※3
  トレース4	0xe241	最後のサーブレットの処理，または最初のフィルタの処理が完了した直後※1	FINER	正常リターンの場合：0 例外リターンの場合：1	サーブレット・フィルタ名※2	リクエストURI※3
  トレース5	0xe330	javax.servlet.Filterまたはorg.springframework.web.server.WebFilterを最初に呼び出す直前	FINE	0	HTTPメソッド	リクエストURI※3
  トレース6	0xe331	最初に呼び出したjavax.servlet.Filterまたはorg.springframework.web.server.WebFilterが完了した直後	FINE	正常リターンの場合：0 例外リターンの場合：1 キャンセルの場合：2※5	HTTPメソッド	リクエストURI※3
  トレース7	0xe332	org.springframework.web.servlet.DispatcherServletによってHandlerを実行する前	FINER	0	Handlerクラス名	-
  トレース8	0xe333	org.springframework.web.servlet.DispatcherServletによってHandlerを実行したあと※4	FINER	0	Handlerクラス名	Viewが存在する場合：Viewクラス名 Viewが存在しない場合：空文字（""）
  トレース9	0xe334	org.springframework.web.servlet.DispatcherServletによってViewレンダリングしたあと	FINER	正常リターンの場合：0 例外リターンの場合：1	Handlerクラス名	正常リターンの場合：空文字（""） 例外リターンの場合：例外クラス名
  トレース10	0xe335	org.springframework.web.servlet.DispatcherServletによって非同期HTTPリクエスト処理を開始したあと	FINER	0	Handlerクラス名	-

  （凡例）

  -：出力なし

  注※1

  1つのリクエストで複数のフィルタやサーブレットが呼び出される場合，最初に呼び出されるものだけがトレース取得の対象です。

  注※2

  Webアプリケーションデプロイ記述子に記載している場合は記載した名前が取得されます。記載していない場合は実装依存の名前が取得されます。

  注※3

  URIにパスワードなどの機密情報が含まれていないことを確認してください。リクエストURIにはパスだけが含まれます（スキームやホスト名は含まれません）。

  注※4

  Handler実行時に例外が発生した場合，0xe333は取得されません。

  注※5

  Spring WebFluxのキャンセル発生時に取得されます。なお，Spring MVCではキャンセルは発生しません。

0xe230を出力したタイミングで，javax.servlet.ServletRequestの属性に次の表に示すアプリケーション情報の文字列表現の値が格納されます。

表15‒8　javax.servlet.ServletRequestの属性に格納されるアプリケーション情報の文字列表現

javax.servlet.ServletRequestの属性名	格納されるアプリケーション情報の文字列表現の値
ucar.rootap	ルートアプリケーション情報の文字列表現
ucar.clientap	クライアントアプリケーション情報の文字列表現

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

HTTPリクエストのトレースのうち，0xe330-0xe335のトレースは，次の条件をすべて満たす場合だけ取得されます。

• Spring Bootビルドツールで作成したアプリケーションを使用する

• AutoConfigure機能が有効である

トレース取得シーケンス

HTTPリクエストのトレース取得シーケンスを次の図に示します。なお，図中の番号（トレース1など）は，「表15-7　HTTPリクエストのトレースの一覧」と対応しています。

図15‒3　HTTPリクエストのトレース取得シーケンス（同期リクエスト）

（凡例）

：処理の流れ

図15‒4　HTTPリクエストのトレース取得シーケンス（非同期リクエスト）

（凡例）

：処理の流れ

図15‒5　HTTPリクエストのトレース出力シーケンス(Spring WebFluxを使用するとき)

（凡例）

：処理の流れ

AP情報：アプリケーション情報

ページの先頭へ