2
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

【QA実務】サーバーログから不具合を切り分ける調査フロー

2
Posted at

はじめに

前回までで、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:は最も深いところまで追う。ただし、それが根本原因とは限らない
  • 以前から出ているエラーも、除外せずに照合する
  • ログにないことは、問題がないことの証明ではない
  • 貼るときはマスクする

これまでと同じく、報告では事実・仮説・未確認事項を分けます。ログを見る目的は、不具合が起きている場所をさらに狭めて、開発者にバトンを渡すことです。

2
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
2
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?