Pythonで例外をログに記録する最良の方法とは？

Pythonプログラムの開発や運用において、例外（エラー）が発生した際にその詳細をログとして残しておくことは、トラブルシューティングやデバッグを行う上で非常に重要です。Pythonでは標準ライブラリのloggingモジュールを使うことで、例外情報を簡単かつ確実にログへ記録できます。

logging.exceptionメソッドで例外ログを作成する

まずloggingモジュールをインポートし、exceptブロック内でlogging.exception()メソッドを呼び出します。このメソッドは、指定したメッセージに加えて、発生した例外の種類やスタックトレース（Traceback）を自動的に付加して、ログレベルERRORで出力してくれます。

コード例

import logging

try:
    print('toy' + 6)
except Exception as e:
    logging.exception("これは例外ログです")

この例では、文字列と整数を連結しようとしてTypeErrorが発生します。

実行結果

ERROR:root:これは例外ログです
Traceback (most recent call last):
  File "example.py", line 3, in <module>
    print('toy' + 6)
TypeError: cannot concatenate 'str' and 'int' objects

出力内容の読み方

• ERROR:root: … ログレベル（ERROR）とロガー名（root）を示しています。
• Traceback: … 例外が発生したファイル名・行番号・該当するコード行が表示されます。
• TypeError: … 発生した例外の種類と、具体的なエラーメッセージが出力されます。

注意点：exceptブロック内でのみ呼び出すこと

Python 3では、logging.exception()は必ずexceptブロックの中で呼び出す必要があります。公式ドキュメントでも警告されている通り、それ以外の場所で呼び出すと、予期しない奇妙な例外が発生する可能性があります。

応用：より柔軟なロギングの方法

ログレベルやフォーマットを細かく制御したい場合は、logging.error()にexc_info=Trueを渡す方法も便利です。

import logging

try:
    print('toy' + 6)
except Exception as e:
    logging.error("例外が発生しました", exc_info=True)

また、logger = logging.getLogger(__name__)のようにモジュールごとに専用のロガーを作成すれば、大規模なアプリケーションでもログの出力先やレベルを柔軟に管理でき、例外の追跡が格段にしやすくなります。