エラーログの読み方|原因を絞り込む調査手順と、安全な記録・共有の方法
プログラムを実行したらエラーが出た。画面が真っ白になった。AIに修正してもらっても、同じ不具合が繰り返される。こうした場面では、コードを書き換える前に、何が起きているかを確認することが大切です。
ログは、処理の経過や失敗の状況を調べるための記録です。この記事では、ログを見る場所、エラーメッセージの読み方、原因の仮説を確かめる手順、AIや他の人へ安全に相談する方法を整理します。
目次
1.エラーログで分かること・分からないこと
ログには、処理を開始した時刻、実行した操作、処理結果、発生した例外などが記録されます。ただし、何が残るかは、アプリケーションの実装や設定によって異なります。変数の値や処理の経過が、すべて自動的に保存されるわけではありません。
また、ログにエラーが出た場所と、問題の根本原因がある場所は一致するとは限りません。例えば、必要なデータが前の処理で作られなかった結果、後の処理でそのデータを参照してエラーになることがあります。
そのため、ログから読み取れた事実と、原因として考えられることを分けましょう。「何が失敗したか」を確認し、その前の処理や入力を調べて、仮説を絞り込んでいきます。
| 確認できた事実の例 | まだ断定できないこと |
|---|---|
| サーバーがHTTP 500を返した | どのコードや設定が原因なのか |
| ファイルが見つからないという例外が出た | ファイルが未作成なのか、指定した場所が違うのか |
| 外部サービスへの接続がタイムアウトした | 相手側の障害なのか、通信経路や自分の設定の問題なのか |
| 必要な項目を参照したところで例外が出た | 入力、変換処理、保存処理のどこで項目が失われたのか |
2.最初に、どこで起きた問題かを確認する
Webアプリでは、ブラウザ、サーバー、データベース、外部APIなど、複数の場所で処理が行われます。画面に表示されたエラーだけで判断せず、どこまで処理が進んだかを確認しましょう。
例えば、ボタンを押しても動かない場合、ブラウザ内のJavaScriptで止まっていることもあれば、サーバーへの通信が失敗していることもあります。確認する場所を分けると、調査対象を絞りやすくなります。
| 起きていること | 最初に確認する場所 | 確認する内容 |
|---|---|---|
| Pythonなどのプログラムが実行中に止まる | 実行したターミナル、設定したログの出力先 | 例外の種類、メッセージ、ファイル名、行番号 |
| Webページのボタンや表示が動かない | ブラウザの開発者ツールのConsole | JavaScriptのエラー、警告、処理の記録 |
| データ取得や送信がうまくいかない | 開発者ツールのNetwork | 通信の有無、HTTPステータス、応答内容、所要時間 |
| サーバーがエラーを返す | アプリケーション、Webサーバー、実行基盤のログ | 該当時刻の処理、例外、起動状況 |
| 公開や更新の途中で失敗する | ビルド・デプロイの実行ログ | 失敗した工程、依存関係、設定や権限 |
ChromeのNetworkパネルでは、通信のステータスや応答を確認できます。調べたい操作の前に開発者ツールを開き、必要に応じてページを再読み込みして、通信を記録してください。
なお、ブラウザ側からサーバー内部のログを直接確認できるわけではありません。自分が管理するアプリなら、サーバー側の管理画面やログ出力先も調べます。
3.ログは「時刻・処理・メッセージ・呼び出し元」を読む
発生時刻と対象の処理をそろえる
まず、問題が起きた時刻と、その直前に行った操作を確認します。複数の利用者や処理の記録が混ざる場合は、リクエストIDなど、同じ処理を追跡するための識別子が役立ちます。
端末とサーバーでタイムゾーンが違うと、同じ出来事でも時刻の表示がずれます。時刻を照合するときは、UTCなのか日本時間なのかも確認してください。
ERRORだけに絞りすぎない
ログレベルは、記録の重要度や用途を表します。名前や扱いは環境によって異なりますが、Pythonの標準的なログ機能では、次のレベルが使われます。
| レベル | 主な用途 |
|---|---|
| DEBUG | 調査に使う詳細な情報 |
| INFO | 通常の処理が進んだことの記録 |
| WARNING | 想定外の状況や、今後の問題につながる兆候 |
| ERROR | 問題により、一部の機能を実行できなかったこと |
| CRITICAL | プログラムの継続に関わる重大な問題 |
ERRORは調査の入口になりますが、その行だけで原因が分かるとは限りません。同じ処理に関する直前のWARNINGやINFOも読み、どの段階までは進んでいたのかを確認します。
また、ログが表示されない場合は、出力レベルの設定も確認しましょう。例えば、Pythonの標準的な初期設定では、INFOやDEBUGのメッセージはそのままでは表示されません。
スタックトレースは、言語ごとの表示順を確認する
スタックトレースは、例外が発生した際の関数の呼び出し関係を示す情報です。プログラム全体の操作履歴を、最初から最後まですべて記録したものではありません。
Pythonの通常のトレースバックでは、末尾に例外の種類とメッセージが示されます。まずそこで何が起きたかを読み、関連するファイル名や行番号を確認してください。複数の例外が連鎖している場合は、その前に示された例外も読みます。
表示順は言語やツールによって異なります。「必ず一番上を見る」「必ず最後の行だけを直す」と決めつけず、例外が表面化した場所と、その値を作った処理を追いましょう。
Pythonの実行場所や環境が曖昧な場合は、エディターと実行環境の関係から確認しましょう。VS Codeでの環境構築と実行手順を紹介しています。
VS CodeでPythonを始める方法|環境構築・実行手順とアルゴリズムの基礎 記事を読む →4.具体例で学ぶ、ログから原因を絞り込む手順
ここでは、得点を登録する学習アプリを例にします。次のログは説明用に作成した架空の記録であり、実際のシステムから取得したものではありません。
2026-10-11T10:15:00+09:00 INFO request_id=demo-001 score_save_started
2026-10-11T10:15:00+09:00 WARNING request_id=demo-001 score_key_present=False
2026-10-11T10:15:00+09:00 ERROR request_id=demo-001 KeyError: ‘score’
この記録では、得点の保存処理が始まり、その処理でscoreという項目が存在しないことが記録されています。さらに、scoreを参照する場面でKeyErrorが発生したことが分かります。
ただし、これだけでは、入力画面が項目を送らなかったのか、途中の処理で項目名が変わったのかまでは分かりません。次のように、仮説と確認方法を対応させます。
| 原因の仮説 | 確認方法 |
|---|---|
| 入力画面がscoreを送っていない | 検証用データで、送信する項目名を確認する |
| scoreではなくpointsという名前で送っている | 送信側と受信側の項目名、仕様を照合する |
| 途中の変換処理でscoreが落ちている | 変換前後で、必要な項目が存在するかを確認する |
| 未入力を受け付ける設計なのに、必須項目として参照している | 未入力時の仕様と、入力チェックを確認する |
エラーを消す前に、正しい動作を決める
scoreがないときに、無条件で0を入れる修正をすれば、例外を避けられるかもしれません。しかし、未入力と0点が異なる意味なら、誤ったデータを保存することになります。
まず、未入力は受け付けないのか、未採点として保存するのかを決めてください。そのうえで、入力チェックや保存処理を修正します。
例えば、「0〜100の整数を必須とする」という仕様なら、通常の得点だけでなく、0点、未入力、文字列、範囲外の値も確認対象です。以下は、その仕様を前提とした確認例です。
| 入力の例 | 期待する動作 |
|---|---|
| 80 | 80点として保存する |
| 0 | 未入力と混同せず、0点として保存する |
| scoreの項目がない | 入力不足を伝え、保存しない |
| 「未入力」という文字列 | 型の不一致を伝え、保存しない |
| 101 | 範囲外であることを伝え、保存しない |
5.再現・仮説・修正・確認を、小さく繰り返す
調査では、期待する動作と実際の動作を並べ、問題が起きる手順を整理します。修正前のコードや設定を残しておくと、変更によって別の問題が起きた際にも比較できます。
複数の箇所を一度に変えると、どの変更が結果に影響したか分かりにくくなります。原因の候補ごとに確認方法を決め、必要な変更を加えて、その結果を確かめましょう。
- 状況を記録する:期待する動作、実際の動作、発生時刻、操作手順を残す。
- 安全な環境で再現する:開発・検証環境と、機密情報を含まないデータを使う。
- 仮説を確かめる:ログ、入力、設定、直前の変更を照合する。
- 修正する:例外を隠すだけでなく、仕様に合う動作へ直す。
- 確認する:元の不具合、通常の操作、境界となる入力で結果を見る。
再現できない場合も、調査を止める必要はありません。発生した環境、頻度、利用していた版、直前の変更などを比較し、次回の発生時に必要な情報を記録できるようにします。
ただし、本番環境で障害を意図的に再現すると、利用者やデータに影響する場合があります。決済、送信、削除などを伴う処理は、実行する環境と対象を十分に確認してください。
6.AIへ相談するときは、必要な情報を整理して渡す
AIに相談するときは、エラーメッセージだけでなく、何をしようとしたか、どの操作で起きるかを伝えます。使っている言語やライブラリのバージョンも、修正案が自分の環境に合うかを判断する材料になります。
ログを共有する前には、APIキー、パスワード、認証用Cookie、アクセストークン、個人情報などを取り除いてください。エラーメッセージやURL、ファイルパスの中にも、共有すべきでない情報が含まれる場合があります。
次の不具合を調べてください。
まず、確認できる事実と原因の仮説を分けてください。
【期待する動作】
何ができれば正常なのかを記載。
【実際の動作】
画面の状態や処理結果を記載。
【再現手順】
問題が起きるまでの操作を順番に記載。
毎回起きるのか、時々起きるのかも記載。
【実行環境】
OS、言語、主なライブラリのバージョンを記載。
開発環境か本番環境かも記載。
【ログと関連コード】
機密情報を取り除いたログと、関係するコードを記載。
省略した部分がある場合は、その旨を明記。
【すでに試したこと】
変更した内容と、その結果を記載。
原因候補ごとに、確認方法を提案してください。
修正案には、変更箇所・理由・動作確認の項目を付けてください。
情報が足りない場合は、追加で必要な情報を示してください。
実行していないコードを、動作確認済みと表現しないでください。
AIの説明が自然でも、原因が確認できたとは限りません。提案された変更内容を読み、手元の環境で結果を確かめてから採用しましょう。原因に関係しない大規模な書き換えが含まれていないかも確認します。
AIから修正コードを受け取った後は、仕様に合っているか、別の動作を壊していないかを確認します。レビューとテストの進め方をこちらで整理しています。
AI生成コードのレビュー方法|仕様・テスト・保守性を確認する実践手順 記事を読む →7.ログと調査メモを、次の開発に役立てる
調査後は、エラーメッセージだけでなく、原因を確認した方法と修正結果を残します。同じメッセージでも原因が違う場合があるため、過去の修正をそのまま当てはめないよう、発生条件も記録しましょう。
| 記録する項目 | 内容の例 |
|---|---|
| 発生条件 | 特定の画面から、未入力のまま保存したとき |
| 現象 | 保存に失敗し、scoreに関するKeyErrorが出た |
| 確認できた原因 | 送信項目と受信側の必須項目が一致していなかった |
| 修正内容 | 項目名をそろえ、未入力時のチェックを追加した |
| 確認したこと | 通常入力、0点、未入力、範囲外の値で動作を確認した |
| 関連情報 | 対象のバージョン、修正したコミット、残っている課題 |
運用ログは、容量、保存期間、閲覧できる人を決めて管理します。日付や容量に応じてファイルを切り替えるログローテーションも、保存領域を管理する方法の一つです。
調査用だからといって、入力データを丸ごと保存し続ける必要はありません。「必要な項目があるか」「処理対象は何件か」など、目的に足りる情報を選び、一時的に増やした詳細ログも調査後に見直してください。
8.エラーログに関するよくある質問
画面が真っ白なのに、ログが見つからない場合は?
まず、ブラウザのConsoleとNetworkで、JavaScriptのエラーや通信の失敗がないか確認します。その後、サーバー側の出力先、ログレベル、アプリケーションが起動しているかを調べてください。
例外が発生しない表示上の不具合や、アプリケーションに届く前の失敗もあります。ログがないことだけで正常とは判断せず、画面の構造や処理の流れも確認しましょう。本番画面へ詳細な内部情報を表示する設定変更は避けてください。
エラーをtry-exceptで囲めば、修正したことになりますか?
例外を捕まえて表示しなくなっただけでは、正しい処理に直ったとは限りません。失敗したことを利用者や呼び出し元へ伝えるのか、再試行できるのかなど、必要な動作を決めてください。
原因を調べずに、すべての例外を無視する処理を入れると、不具合を発見しにくくなります。想定する例外を適切に扱い、予期しない失敗を追跡できるようにしましょう。
ログが多すぎる場合は、どう調べればよいですか?
発生時刻、サービス名、リクエストIDなどで対象を絞ります。エラー行だけを抜き出すと前後の経過が失われるため、同じ処理に関する記録を一緒に確認してください。
大量に出力される理由も調べましょう。再試行の繰り返し、同じ例外の重複記録、不要な詳細出力などがないか確認し、必要な記録を残せる設定へ調整します。
まとめ:ログを手掛かりに、確認できることを増やす
エラー調査では、表示された言葉だけから修正方法を決めず、発生条件、ログ、入力、コードを照合することが大切です。原因の仮説を一つずつ確かめ、修正後は元の不具合と通常の動作の両方を確認しましょう。
次にエラーが起きたら、まず「期待する動作」「実際の動作」「再現手順」の3つを記録してみてください。その整理が、ログを読むときにも、AIや他の人へ相談するときにも役立ちます。
参考資料
- Python公式ドキュメント:エラーと例外
- Python公式ドキュメント:Logging HOWTO
- Chrome for Developers:コンソールの概要
- Chrome for Developers:ネットワーク アクティビティを検査する
- MDN:500 Internal Server Error
- OWASP:Logging Cheat Sheet
Learning Tools
記事を検索したい方はここから!
記事を検索
関連記事や、今の内容に近いテーマをすぐに検索できます。
例: AI / 情報Ⅰ / Python / 統計 / 資格 / 学習法