Python / 開発ノウハウ

print() を卒業しよう
Python logging モジュール完全入門

ログは「後から読む人」のために書くもの。適切なロギングを身につければ、デバッグ時間は劇的に短くなります。

開発中、何気なく print() でデバッグしていませんか？小さなスクリプトなら問題ありませんが、本番環境や大規模なアプリでは途端に管理が難しくなります。Python 標準の logging モジュールを使えば、情報の重要度に応じた出力制御や、ファイル・コンソールへの同時書き出しが、コードを書き換えることなく実現できます。

ロギングの4大要素

Python のロギングシステムは、以下の4つのオブジェクトが連携して動く「ロギング・フロー」で構成されています。

5段階のログレベル

数値が大きいほど重要度が高くなります。デフォルトの出力しきい値は WARNING（30） です。

実践コード：明示的なハンドラ設定

最も推奨される構成です。ロガー・ハンドラ・フォーマッタを分けて定義することで、後から柔軟に変更できます。

import logging

# 1. ロガーの生成
logger = logging.getLogger(__name__)
logger.setLevel(logging.DEBUG)  # 最低ログレベルを設定

# 2. ハンドラの作成（コンソール出力用）
console_handler = logging.StreamHandler()
console_handler.setLevel(logging.INFO)  # INFO以上を出す

# 3. フォーマッタの作成
formatter = logging.Formatter(
    '%(asctime)s - %(name)s - %(levelname)s - %(message)s'
)
console_handler.setFormatter(formatter)

# 4. ロガーにハンドラを登録
logger.addHandler(console_handler)

# 実行例
logger.debug("これは表示されません（HandlerがINFO以上のため）")
logger.info("サーバーを起動します")
logger.warning("メモリ使用量が増加しています")
logger.error("データベース接続に失敗しました")

なぜ print() ではなく logging なのか

運用のコツ：__name__ の活用

まとめ：いつ basicConfig を使うか

小規模なスクリプトであれば logging.basicConfig() でも十分です。しかしアプリが成長するにつれ、ハンドラを明示的に分けた構成のほうがメンテナンス性が格段に高まります。