Pythonのloggingモジュール完全入門！初心者でもわかるエラーをログに記録する方法

1. loggingモジュールとは何か？

1. loggingモジュールとは何か？

Pythonのloggingモジュールとは、プログラムの動きやエラー内容を記録するための標準機能です。人が日記を書くように、プログラムも「何が起きたか」を文字として残せます。これをログと呼びます。

エラーが起きた瞬間は画面を見ていなくても、後からログを見ることで原因を確認できます。初心者の方にとっては、失敗の記録を残して復習できる便利な道具です。

2. printとloggingの違い

2. printとloggingの違い

Python初心者の方は、よくprintで状況を確認します。printは画面に文字を出すだけですが、loggingはファイルに保存できます。これは、口頭で説明するのと、紙にメモを書く違いに似ています。

プログラムが終了してもログは残るため、エラー調査や確認に役立ちます。エラーハンドリングと組み合わせることで、安全なプログラム設計ができます。

3. loggingの基本的な使い方

3. loggingの基本的な使い方

まずはloggingモジュールを読み込み、簡単なログを出してみましょう。ここではエラーではなく、情報を記録する例です。

import logging

logging.basicConfig(level=logging.INFO)
logging.info("プログラムが開始されました")

INFO:root:プログラムが開始されました

このように、logging.infoを使うと「情報ログ」が表示されます。levelはログの重要度を表します。

4. エラーをloggingで記録する方法

4. エラーをloggingで記録する方法

次に、例外処理と組み合わせてエラーをログに残す方法を見てみましょう。転んだ理由をメモするイメージです。

import logging

logging.basicConfig(level=logging.ERROR)

try:
    result = 10 / 0
except ZeroDivisionError:
    logging.error("0で割ろうとしました")

ERROR:root:0で割ろうとしました

このように書くことで、エラー内容がはっきりとログに残ります。

5. ログをファイルに保存する設定

5. ログをファイルに保存する設定

画面表示だけでなく、ファイルにログを保存するとさらに便利です。ノートに書き残す感覚で考えてください。

import logging

logging.basicConfig(
    filename="error.log",
    level=logging.ERROR
)

try:
    number = int("abc")
except ValueError:
    logging.error("数字に変換できませんでした")

この設定で、error.logというファイルにエラー内容が保存されます。後から何度でも確認できます。

6. ログレベルの種類と使い分け

6. ログレベルの種類と使い分け

loggingには、重要度を表すログレベルがあります。代表的なものはDEBUG、INFO、WARNING、ERRORです。信号機の色分けのように、状況の重さを示します。

初心者の方は、INFOで動作確認、ERRORで失敗の記録を残すだけでも十分です。すべてを細かく使い分けなくても問題ありません。

7. loggingを使ったエラーハンドリング設計の考え方

7. loggingを使ったエラーハンドリング設計の考え方

loggingを使う目的は、エラーを隠すことではありません。何が起きたかを正確に残すことです。例外処理で画面表示を分かりやすくし、loggingで内部の記録を残すと、安全で親切な設計になります。

これは、お客様には分かりやすく説明しつつ、裏では詳細なメモを取っている状態と同じです。

8. 初心者がloggingで意識したいポイント

8. 初心者がloggingで意識したいポイント

Pythonのloggingモジュールは最初は難しく見えますが、基本は「記録する」だけです。まずはエラーをファイルに残すことを目標にしましょう。

loggingを使うことで、Pythonの例外処理がより実用的になり、後から原因を調べる力も自然と身についていきます。