Pythonのloggingモジュールは、プログラムの実行中に発生するイベントを追跡するための手段を提供します。この記事では、Pythonでログファイルを扱う基本的な方法について説明します。
loggingモジュールの基本
loggingモジュールには、debug(), info(), warning(), error() そして critical() といった便利な関数が用意されています。これらの関数は、それぞれ異なるレベルのログイベントを追跡します。
ログファイルへの出力
Pythonのloggingモジュールを使用して、ログの内容を外部ファイルに出力する方法について見てみましょう。
以下に、ログをファイルに出力する基本的なコードを示します。
import logging
logger = logging.getLogger()
logger.setLevel(logging.DEBUG)
formatter = logging.Formatter('%(asctime)s - %(levelname)s - %(message)s')
fh = logging.FileHandler(filename='./logs/test001.log', encoding='utf-8')
fh.setLevel(logging.DEBUG)
fh.setFormatter(formatter)
logger.addHandler(fh)
logger.debug("ログに出力")
logger.info("ログに出力")
logger.warning("ログに出力")
logger.error("ログに出力")
このコードでは、loggingモジュールを使用して、ログの内容をtest001.logという名前のファイルに出力しています。
logging設定の外部化
loggingの設定情報をソースコードから分離し、外部の設定ファイル（logging.conf）を作成して参照させることも可能です。以下にその例を示します。
import logging.config
logging.config.fileConfig("./conf/logging.conf")
logger = logging.getLogger()
logger.debug("ログに出力")
logger.info("ログに出力")
logger.warning("ログに出力")
logger.error("ログに出力")
この方法では、logging.confという設定ファイルを作成し、その中にloggingの設定情報を記述します。そして、logging.config.fileConfig関数を使用して、その設定ファイルを読み込みます。
以上が、Pythonでログファイルを扱う基本的な方法です。これらの方法を活用することで、Pythonプログラムの動作をより詳細に追跡し、デバッグやエラー解析を効率的に行うことができます。