Pythonのlogging入門: 基本の使い方とログレベル完全解説

# logging_levels_example.py
# 各ログレベルの出力を確認するサンプル

import logging

# INFO以上を出す設定
logging.basicConfig(level=logging.INFO)

logging.debug("これはDEBUGです")
logging.info("これはINFOです")
logging.warning("これはWARNINGです")
logging.error("これはERRORです")
logging.critical("これはCRITICALです")

# basic_minimum.py
import logging

# INFO以上を出力
logging.basicConfig(level=logging.INFO)

logging.info("Hello logging")
logging.warning("注意喚起です")

# console_stream.py
import logging
import sys

# 既に設定済みでも強制的に上書きしたい場合は force=True (3.8+)
logging.basicConfig(
    level=logging.INFO,
    stream=sys.stdout,  # 標準出力へ
    format="%(levelname)s:%(message)s",
    force=True
)

logging.info("標準出力に出ます")

# file_output.py
import logging

logging.basicConfig(
    level=logging.INFO,
    filename="app.log",       # ログファイル名
    filemode="w",             # 上書き(追記なら "a")
    encoding="utf-8",         # 文字化け対策
    format="%(asctime)s %(levelname)s %(message)s",
    datefmt="%Y-%m-%d %H:%M:%S"
)

logging.info("アプリ開始")
logging.warning("ディスク残量が少ないかもしれません")
logging.error("処理に失敗しました")

# format_example.py
import logging

logging.basicConfig(
    level=logging.DEBUG,
    format="%(asctime)s.%(msecs)03d %(levelname)s [%(name)s:%(lineno)d] %(message)s",
    datefmt="%Y-%m-%d %H:%M:%S",
    force=True
)

logger = logging.getLogger(__name__)

logger.info("アプリ起動")
logger.debug("詳細情報。linenoやモジュール名を確認できます")

# interpolate_variables.py
import logging

logging.basicConfig(level=logging.INFO, format="%(levelname)s:%(message)s", force=True)
logger = logging.getLogger(__name__)

user = "alice"
count = 3

# おすすめ: 引数で渡す(遅延フォーマット)
logger.info("ユーザ=%s 件数=%d", user, count)

# 非推奨ではないが注意: f文字列は先に文字列化される
logger.debug(f"ユーザ={user} 件数={count}")  # DEBUGが無効でも文字列化コストがかかる

# module_a.py
import logging

logger = logging.getLogger(__name__)  # "module_a" という名前のロガー

def do_work():
    logger.info("do_work を開始")
    logger.debug("内部処理の詳細")
    return "OK"

# main.py
import logging
import module_a

# アプリ全体の初期化はエントリポイントで1回だけ
logging.basicConfig(
    level=logging.DEBUG,
    format="%(levelname)s:%(name)s:%(message)s",
    force=True
)

logger = logging.getLogger(__name__)

def main():
    logger.info("アプリ開始")
    result = module_a.do_work()
    logger.info("結果=%s", result)

if __name__ == "__main__":
    main()

# avoid_duplicate_handlers.py
import logging
import sys

logger = logging.getLogger("myapp")

# すでにハンドラがあるかを確認
if not logger.handlers:
    handler = logging.StreamHandler(sys.stdout)
    handler.setFormatter(logging.Formatter("%(levelname)s:%(name)s:%(message)s"))
    logger.addHandler(handler)

logger.setLevel(logging.INFO)
logger.propagate = False  # 親(root)へ流さない

logger.info("このメッセージは1回だけ出ます")

# japanese_encoding.py
import logging

logging.basicConfig(
    filename="nihongo.log",
    level=logging.INFO,
    encoding="utf-8",
    format="%(asctime)s %(levelname)s %(message)s",
    datefmt="%H:%M:%S",
    force=True
)

logging.info("日本語が正しく記録されます")
logging.info("絵文字もOKです 👍")

# root_vs_named.py
import logging

logging.basicConfig(level=logging.INFO, format="%(name)s:%(message)s", force=True)

root = logging.getLogger()          # root
named = logging.getLogger("myapp")  # 子ロガー

root.info("rootからのメッセージ")
named.info("myappからのメッセージ")

# log_exception.py
import logging

logging.basicConfig(level=logging.ERROR, format="%(levelname)s:%(message)s", force=True)

def div(a, b):
    return a / b

try:
    div(1, 0)
except ZeroDivisionError:
    logging.exception("0除算が発生しました")

# level_from_env.py
import logging
import os

level_name = os.getenv("LOG_LEVEL", "INFO").upper()
# 無効な値なら INFO にする
level = getattr(logging, level_name, logging.INFO)

logging.basicConfig(level=level, format="%(levelname)s:%(message)s", force=True)
logger = logging.getLogger(__name__)

logger.debug("DEBUGメッセージ")
logger.info("INFOメッセージ")
logger.warning("WARNINGメッセージ")