はじめに
前回までで、DevToolsによるFE/BEの切り分けと、Request・Response・DBを使った切り分けについて書きました。
今回はその先、サーバーログを使った切り分けです。前回の最後に書いた「再現時刻を残す」は、このための準備でした。
QAがログを見る目的は、原因を言い当てることではなく、該当のRequestで何が起きていたかの手がかりを拾って、開発者に渡すことだと考えています。
なお、例はJava(Spring Boot)+MySQLの構成で書いていますが、考え方は他の言語でも同じです。
1. 見る範囲を先に絞る
ログをファイルの先頭や末尾から眺め始めると、ほぼ確実に迷子になります。環境によってはERRORやWARNが常に出ているので、見つけたものが今回の不具合と関係あるのかも判断できません。
絞る材料は、時刻とRequest IDです。
時刻:まずタイムゾーンを確認する
「再現した時刻の前後を探したのにログが見つからない」場合、よくある原因がタイムゾーンのズレです。
再現時刻(JST) :2026/09/10 10:15:32
ログ上の時刻(UTC) :2026-09-10 01:15:32
ログのタイムゾーンは、ベースイメージやJVM、ログ出力の設定によって決まります。クラウドやコンテナ上の環境では、UTCで出力されていることも珍しくありません。一方でDBのupdated_atはJSTで保存されている、というように、同じシステムの中でタイムゾーンが混在していることもあります。
確認するのは次の2点です。
- ログのタイムゾーン(UTCかJSTか)
- DBの時刻列のタイムゾーン
見る範囲は、再現時刻の前後30秒〜1分程度にします。なお、CloudWatch LogsやDatadogなどのログ基盤では、ログが検索できるようになるまで数十秒かかることがあります。再現直後に見つからなくても、少し待ってから再検索します。
Request ID / Trace ID
時刻だけで探すと、他のユーザーや他のQA・開発者のRequestが混ざります。
Request IDがResponse Headerに入っていれば、DevToolsのNetworkタブで拾えます。
x-request-id: 8f3a21c4
このIDでログを検索すれば、そのRequestに関するログだけを追えます。実際の現場ではgrepよりも、Kibana、CloudWatch Logs Insights、Datadogなどの検索画面を使うことが多いと思いますが、やることは同じです。
IDが取れない場合は、時刻・URL・User IDの組み合わせで絞ります。非同期処理のJobやWorkerにはIDが引き継がれていないことがあるので、その場合は対象データのIDで追います。
2. エラーログと「Caused by」を確認する
エラーは連鎖することがあります。ログの一番下のERRORは、あとから連鎖して出ているものかもしれません。
01:15:32.431 ERROR DataIntegrityViolationException ... ← 最初に発生
01:15:32.433 ERROR UnexpectedRollbackException:
Transaction silently rolled back because it has been marked as rollback-only ← 続けて発生
01:15:32.435 ERROR Unhandled exception in controller ← 続けて発生
※これは例示用のログです。実際に出力される例外や順序は、例外処理・トランザクションの実装によって異なります。
Spring系では、根本のエラーのあとに「トランザクションがロールバックされた」という例外が続くことがあります。一番下のUnexpectedRollbackExceptionだけを見ても、なぜロールバックされたのかは分かりません。
まず、該当Requestに紐づくエラーログを確認し、どの例外が発生しているかを見ます。
複数の例外が記録されている場合は、前後のログや処理の流れを確認します。スタックトレースにCaused by:があれば、最も深い例外まで追います。ただし、それが必ずしも不具合の根本原因とは限らないため、前後のログや処理内容と合わせて判断します。
3. 以前から出ているエラーは、除外せず照合する
テスト環境では、不具合とは無関係なERROR・WARNが定期的に出続けていることがあります。例えば、連携先サービスのモックが止まっていて接続エラーが毎分出ている、ヘルスチェックの失敗が出ている、などです。
一方で、以前から出ているエラーが今回の不具合に関係している可能性もあります。定期実行の処理が失敗し続けている、システムの状態に依存している、といったケースです。
そこで、再現前のログも確認し、同じエラーが以前から出ていないかを見ます。ただし、以前から出ているという理由だけでは除外しません。Request IDや対象データ、発生タイミングを照合して、今回の事象と関係があるかを判断します。
判断がつかない場合は、「再現前からも出ている」ことを事実として、「今回の事象との関連」を未確認事項として、報告に残します。
4. スタックトレースは3点だけ見る
全部は読みません。QAとして最低限拾うのは次の3点です。
- 例外のクラス名(何が起きたか)
- メッセージ(どういう理由か)
- 自社コードの最初の行(どのあたりの処理か)
java.lang.NullPointerException: Cannot invoke "String.length()" because the return value of "com.example.user.UserDto.getName()" is null
at com.example.user.UserService.update(UserService.java:87)
at com.example.user.UserController.update(UserController.java:42)
at java.base/jdk.internal.reflect.DirectMethodHandleAccessor.invoke(...)
...
この例なら、NullPointerException、getName()の戻り値がnull、UserService.updateの87行目付近、というところまで拾えます。上から順に見て、最初に自社のパッケージ名が出てくる行が手がかりです。
ただし、これで原因が確定するわけではありません。「この付近で例外が出ている」という事実を渡すための材料です。
5. 「ログにない」は「問題がない」ではない
ログにERRORがなくても、処理が正常だったとは限りません。
- ログレベルがINFO以上で、DEBUGが出力されていない
- エラーが握りつぶされて(catchされて)ログに残っていない
- サーバーが複数台あり、見ているのとは別のサーバーにRequestが振られていた
- 別サービスのログに出ている
特に複数台構成では、1台のログだけを見て「何も出ていない」と判断しがちです。全サーバーのログをまとめて検索できるかどうかは、先に確認しておきます。
報告には「ログにエラーはなかった」ではなく、「確認した範囲のログにはエラーがなかった」と書きます。
6. ログを貼るときはマスクする
アプリによっては、Requestの内容がそのままログに出力され、メールアドレスや認証情報が含まれています。チャットやチケットに貼る前に、個人情報・トークン・APIキー・顧客情報をマスクします。
貼る範囲は、該当のRequest IDに関する部分だけに絞ります。それ以外は「ログの場所」と「検索に使ったID」を書いておけば、開発者が自分で追えます。
実務例:保存したら500エラーになった
事象
ユーザー編集画面でメールアドレスを変更して保存したところ、「保存に失敗しました」と表示された。
① Network
PUT /api/users/123
HTTP 500
x-request-id: 8f3a21c4
{ "email": "yamada@example.com" }
Requestは仕様どおりで、サーバー側でエラーになっています。再現時刻は2026/09/10 10:15:32 JSTです。
② ログを探す
ログがUTCであることを確認し、01:15前後をRequest IDで絞りました。
2026-09-10 01:15:32.418 INFO [8f3a21c4] c.e.user.UserController : PUT /api/users/123
2026-09-10 01:15:32.431 ERROR [8f3a21c4] c.e.common.GlobalExceptionHandler : Unhandled exception
org.springframework.dao.DataIntegrityViolationException: could not execute statement
Caused by: org.hibernate.exception.ConstraintViolationException: could not execute statement
Caused by: java.sql.SQLIntegrityConstraintViolationException:
Duplicate entry '***@example.com' for key 'users.uk_email'
※メールアドレスはマスクしています。
一番深いCaused byにDuplicate entry ... for key 'users.uk_email'があります。再現の1〜2分前のログには同じエラーは出ていませんでした。
③ 追加で確認
DBを確認すると、入力したメールアドレスは別のユーザーですでに使われていました。
④ 報告
確認できた事実
-
PUT /api/users/123が500を返している - 同じRequest IDのログに
Duplicate entry ... for key 'users.uk_email'が出ている - 入力したメールアドレスは、別のユーザーですでに使用されている
現時点の仮説
メールアドレスの重複によりDBの一意制約違反が発生し、その例外が500として返却されている可能性があります。
未確認事項
- アプリ側での重複チェックや例外処理の有無
- 重複時に返す想定のステータスコード・エラーメッセージ(仕様)
- 画面に表示するメッセージの仕様
ここで大事なのは、「500が正しいかどうか」はログではなく仕様で決まるという点です。ログで分かるのは「何が起きたか」までで、「どうあるべきか」は仕様を確認しないと判断できません。
ログを見られない環境の場合
権限の都合で、ログを開発者しか見られない現場も多いです。その場合は、次の情報を残して渡します。
- 再現時刻(タイムゾーンつき)
- Request ID / Trace ID
- User ID・対象データID
- 再現手順
「さっき500が出ました」と、「2026/09/10 10:15:32 JST、Request IDは8f3a21c4、User IDは123です」とでは、ログを探す側の手間がまったく違います。
まとめ
- ログは時刻とRequest IDで絞る。時刻は先にタイムゾーンを確認する
- 該当Requestのエラーログを確認し、Caused by:は最も深いところまで追う。ただし、それが根本原因とは限らない
- 以前から出ているエラーも、除外せずに照合する
- ログにないことは、問題がないことの証明ではない
- 貼るときはマスクする
これまでと同じく、報告では事実・仮説・未確認事項を分けます。ログを見る目的は、不具合が起きている場所をさらに狭めて、開発者にバトンを渡すことです。